The IG.GFX.Packager is a tool, to:

• convert typescript to javascript
• build IG packages for interactors, evaluators and context
• upload it to the IG.Creator

• IG.GFX.Packager and IG.GFX.Packager from the Tools repo, lastest versions
• node.js version 15.0.0
• IG.Creator login + extra lizence for uploading files to the database

Get the IG.GFX.Packager.zip file from the tools repo and unzip it into your folder directory

To upload a package into the IG.Creator, the IG.GFX.Packager requires a set of predefined environment variables.

In case the IG.GFX.Packager is used inside a common project, the folder structure looks like:

 
-ProjectFolder
    -SubProjectFolderEval
       -Scripts
           -_Index.json
           -_Package.json
           -_AnyScript.ts
    -SubProjectFolderInt
       -Scripts
           -_Index.json
           -_Package.json
           -AnyScript.ts
    -SubProjectFolder
       +Factory
       +Geometries
       -Scripts
           -_Index.json
           -_Package.json
           -Context.ts
           -AnyScript.ts
    -build.txt
    -package.json
       

First of all, inside the ProjectFolder open a command line or terminal and install the IG.GFX.Packager. This will add the node_modules folder with its packages.

This procedure need to be done only at the very first beginning of a project. As soon as this IG.GFX.Packager is installed inside this ProjectFolder, this command is not needed any more .

Next step is to set up the the package.json. For this follow the instructions from the IG.GFX.Packager web side. The resulting package.json looks like:

{
  "devDependencies": {
    "@intelligentgraphics/ig.gfx.packager": "Here is the latest version or higher (^) written"
  },
  "scripts": {
    "build": "packager build",
    "upload": "packager publish"
  },
  "packager": {
    "banner": "This file is part of the IG.Graphics XYZ Data Package. \n Copyright (C) intelligentgraphics. All Rights Reserved."
  }
}

Also, this part is set up one time per project. Push it to git, so everyone can work on this package.json

Next step is to create and fill the build.txt. This file is a help file to remember the needed steps to push to the creator. The commands needed here are explained on the IG.GFX.Packager web side.

copy and paste this to Console/Cmd window:

this should normally defined in your environment:

SET IG_GFX_ASSET_SERVICE=http://ig5.intelligentgraphics.biz:8087

Comments:
For a new project use 1.0.0.100 as release version number and 1.0.0.1 as dev version number.
Usually version numbers will be increased within the release process.
Sort the workspaces alphabetically!.

=====================================================
=====================================================

PACKAGES

========= ProjectFolder =========

Release:
npm run upload ProjectFolder -- --newVersion=1.0.0.100
Dev:
npm run upload ProjectFolder -- --newVersion=1.0.0.1

On the top of the file, there is a generall how to. After PACKAGES each package is listed separatly with the given template. Sort the projects alphanumerically, to keep a better overview! Each project has two commands. The command under Release is used when a package is published. The command under Dev/ is used for develepment. The numbers are increased when it is nessesary for releases or new development steps

Make sure not to match the version numbers, this will lead to problems on the live server

The build.txt is pushed to git to, so every one can use it.