Generating Code

If you develop apps based on Nexacro, all those programs will be converted into either JavaScript files or CSS files. This conversion process is called generation. Generated apps can be run on web browsers powered by operating systems. Otherwise, they are available in the Nexacro runtime environment (NRE).

To deploy a project that you develop through Nexacro Studio, you need to convert the codes of the project so that they are ready to be deployed. This conversion process is called "generation". You can generate codes through the menu [Generate] or [Deploy] in Nexacro Studio. However, it is better to use Nexacro Deploy when a project's scale is large or when you use an automatic build system. Nexacro Deploy is a tool for automatic generation and deployment.

Types of Nexacro Deploy

You can select and use the appropriate Nexacro Deploy according to your purpose.

Options

Required Options

The below three options must be specified.

nexacrodeploy.exe -P [ARG] -O [ARG] -B [ARG]
start.bat -P [ARG] -O [ARG] -B [ARG]
start.sh  -P [ARG] -O [ARG] -B [ARG]

CSS Rule Option

After installing Nexacro Studio version 21.0.0.1500 or higher, if you set a library version lower than the version 21.0.0.1500 in the -B option, the CSS Rule option must be set.

Options for Specifying Target Files

If you do not set the below options, the deployment tool will work on all the files in a project.

Generate Options

If you want to specify the NRE and IE11, write code as below.

nexacrodeploy.exe -P -O -B -BROWSER "NRE,Internet Explorer 11"
start.bat -P -O -B -BROWSER "NRE,Internet Explorer 11"
start.sh -P -O -B -BROWSER "NRE,Internet Explorer 11"

Deploy Options

Other options

Examples

Generate

Generate entire Application

• You can generate an Application based on C:\TestGenerate\TestGenerate.xprj file and produce the result to the E:\ResultGenerate folder.

• You also can generate the files necessary to run the app (the console does not generate bootstrap files except for the ones related to the execution of the NRE or web browsers.)

• The generation is conducted by referring to the path of base libraries, specified as the -B option.

nexacrodeploy.exe  -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate" -B "C:\TestGenerate\nexacrolib"

Generate only certain file

• You can generate the C:\TestGenerate\aa.xfdl file specified as the -FILE option and produce the result to the E:\ResultGenerate folder.

nexacrodeploy.exe -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate"  -B "C:\TestGenerate\nexacrolib" -FILE "C:\TestGenerate\aa.xfdl" 

• You also can generate a theme file by specifying the ID of the target theme file.

nexacrodeploy.exe -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate"  -B "C:\TestGenerate\nexacrolib" -FILE "theme::default"

• You can generate n number of files and produce the result to the E:\ResultGenerate folder.

nexacrodeploy.exe -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate"  -B "C:\TestGenerate\nexacrolib" -FILE "'C:\TestGenerate\aa.xfdl','C:\TestGenerate\bb.xfdl','C:\TestGenerate\cc.xfdl'" 

When generating only specific services

• Generate only the files corresponding to the Base service specified with the -SERVICE option and then create them under the "E:\ResultGenerate" folder.

nexacrodeploy.exe -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate"  -B "C:\TestGenerate\nexacrolib" -SERVICE "Base" 

• Generate n number of services and then create them under the "E:\ResultGenerate" folder.

nexacrodeploy.exe -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate"  -B "C:\TestGenerate\nexacrolib" -SERVICE "Base,FrameBase" 

Generate only module files

• You can generate only the module files in use located at C:\TestGenerate\nexacrolib and produce the result to the E:\ResultGenerate folder.

nexacrodeploy.exe -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate"  -B "C:\TestGenerate\nexacrolib" -MODULE

Generate only bootstrap files

• You can generate bootstrap files of all OS types needed to run your app and produce the result to the E:\ResultGenerate folder.

nexacrodeploy.exe -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate"  -B "C:\TestGenerate\nexacrolib" -BOOTSTRAP

Generate bootstrap files but not archive them. (iOS)

• You can generate bootstrap files of all OS types needed to run your app and produce the result to the E:\ResultGenerate folder. However, the result will be the Run.html file rather than Run.zip.

nexacrodeploy.exe -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate"  -B "C:\TestGenerate\nexacrolib" -BOOTSTRAP -UNARCHIVE

Deploy

Deploy entire Application

• The application deployer generates files and produces the result to the path specified as the -O option. Then, it creates the files for deployment in the directory specified as the -D option.

• In this case, all the options are applied to the generation process, which produces the result to the path specified as the -O option. (-R, -BROWSER, etc.)

• The files in the directory of the -D option are produced based on the files in the directory of the -O option.

nexacrodeploy.exe  -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate" -B "C:\TestGenerate\nexacrolib" -D "E:\ResultDeploy"

Module merge option

• You can create one JavaScript file by combining the JavaScript files in the nexacrolib folder. When you do so, the JavaScript files in nexacrolib will change their names in tandem with each relevant JSON file.

• You can create the Framework.json file by merging all the JavaScript files in the framework folder.

nexacrodeploy.exe  -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate" -B "C:\TestGenerate\nexacrolib" -D "E:\ResultDeploy" -MERGE

Compress option

• You can compress JavaScript files by removing their comments and whitespaces and thus making each file one-line code.

nexacrodeploy.exe  -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate" -B "C:\TestGenerate\nexacrolib" -D "E:\ResultDeploy" -COMPRESS

• While compressing JavaScript files to make each file one-line code with their comments and whitespaces removed, you can also obfuscate the variables of those JS files at the same time. However, a function will not be obfuscated if it contains an eval statement.

nexacrodeploy.exe  -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate" -B "C:\TestGenerate\nexacrolib" -D "E:\ResultDeploy" -COMPRESS -SHRINK

• While compressing JavaScript files to make each file one-line code with their comments and whitespaces removed, you can also obfuscate the variables of those files at the same time. Moreover, you can insist on obfuscation by ignoring eval statements included in functions.

nexacrodeploy.exe  -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate" -B "C:\TestGenerate\nexacrolib" -D "E:\ResultDeploy" -COMPRESS -SHRINK -IGNOREEVAL

• Script (JS) files are compressed with 1line code with notes and spaces removed.

• The js files designated in the ".ignorecompress" file are not compressed.

  The ".ignorecompress" file is automatically created when [Ignore compress files] is set in the Nexacro Studio’s Compress option. If the file is created manually, the ".ignorecompress" file should be located in the same path as the xprj file and should be set as an XML file as follows.

  Create files with js extensions to be excluded when compressing based on the output path (it will not work properly if only the folder is set).

nexacrodeploy.exe  -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate" -B "C:\TestGenerate\nexacrolib" -D "E:\ResultDeploy" -COMPRESS -IGNORECOMPRESS "C:\TestGenerate\.ignorecompress"

<?xml version="1.0" encoding="utf-8"?>
<CompressConfigue version="1.0">
  <IgnoreCompress>
    <File path=".\Service0\test01.js"/>
    <File path=".\Service0\test02.js"/>
  </IgnoreCompress>
</CompressConfigue>

Compile option

• You can compress deployment files by encoding them with the format applicable only to the NRE. The resulting encoded files cannot be read through other editor programs.

nexacrodeploy.exe  -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate" -B "C:\TestGenerate\nexacrolib" -D "E:\ResultDeploy" -COMPILE

Others

Save generation result as log file

• You can generate an Application based on C:\TestGenerate\TestGenerate.xprj file and produce the result to the E:\ResultGenerate folder. Then, you can save the details of the generation in the form of the C:\Log.txt file.

nexacrodeploy.exe  -P "C:\TestGenerate\TestGenerate.xprj" -O "E:\ResultGenerate" -B "C:\TestGenerate\nexacrolib" -L "C:\log.txt"