Package your app from scratch

Search…
Requirements
This guide is intended for devs who have gone through get started or have knowledge of:
​TotalCross SDK;
​Environment variables configured;
​JDK installed.
Deploy
You can do deploy to Android, iOS e Windows with Maven or by Command Line
Maven
Command Line
Pom File
Make sure your pom file has the build tag, dependencies tag, repositories tag and properties tag as shown below
1
<?xml version="1.0" encoding="UTF-8"?>
2
<project xmlns="http://maven.apache.org/POM/4.0.0"
3
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
5
    <modelVersion>4.0.0</modelVersion>
6
​
7
    <groupId>com.totalcross</groupId>
8
    <artifactId>HelloWorld</artifactId>
9
    <version>1.0-SNAPSHOT</version>
10
    <name>HelloWorld</name>
11
​
12
    <properties>
13
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
14
        <totalcross.activation_key>PLACE_YOUR_KEY</totalcross.activation_key>
15
    </properties>
16
​
17
    <dependencies>
18
        <dependency>
19
            <groupId>com.totalcross</groupId>
20
            <artifactId>totalcross-sdk</artifactId>
21
            <version>6.0.3</version>
22
        </dependency>
23
    </dependencies>
24
​
25
    <repositories>
26
        <repository>
27
            <id>totalcross-repo</id>
28
            <name>ip-172-31-40-140-releases</name>
29
            <url>http://maven.totalcross.com/artifactory/repo1</url>
30
        </repository>
31
    </repositories>
32
​
33
    <pluginRepositories>
34
        <pluginRepository>
35
            <id>totalcross-repo</id>
36
            <name>ip-172-31-40-140-releases</name>
37
            <url>http://maven.totalcross.com/artifactory/repo1</url>
38
        </pluginRepository>
39
    </pluginRepositories>
40
​
41
    <build>
42
        <finalName>${project.artifactId}</finalName>
43
        <plugins>
44
            <plugin>
45
                <groupId>org.apache.maven.plugins</groupId>
46
                <artifactId>maven-compiler-plugin</artifactId>
47
                <version>3.1</version>
48
                <configuration>
49
                    <source>1.8</source>
50
                    <target>1.8</target>
51
                </configuration>
52
            </plugin>
53
            <plugin>
54
                <groupId>com.totalcross</groupId>
55
                <artifactId>totalcross-maven-plugin</artifactId>
56
                <version>1.0</version>
57
                <configuration>
58
                    <name>${project.name}</name>
59
                    <platforms>
60
                        <platform>-win32</platform>
61
                        <platform>-android</platform>
62
                        <platform>-ios</platform>
63
                    </platforms>
64
                    <activationKey>${totalcross.activation_key}</activationKey>
65
                    <!--                    For version 4.4.2 and 5.1.4 or later, Apple certificates are no longer required. -->
66
                    <!--                    <certificates>${totalcross.applecertificate}</certificates>-->
67
                    <!--                    <totalcrossHome>/Users/italo/TotalCross5</totalcrossHome>-->
68
                </configuration>
69
                <executions>
70
                    <execution>
71
                        <id>post-package</id>
72
                        <phase>package</phase>
73
                        <goals>
74
                            <goal>package</goal>
75
                        </goals>
76
                    </execution>
77
                </executions>
78
            </plugin>
79
        </plugins>
80
    </build>
81
</project>
Copied!
Inside the platfrom tag you can add the argument:
Argument for plataforms to deploy
<platform>-win32</platform>This platform is used to build for Windows;
<platform>-wince</platform>This platform is used to build for Windows CE;
<platform>-winmo</platform>This platform is used to build for Windows Mobile Only;
<platform>-linux</platform>This platform is used to build for Linux x86 (Debian);
<platform>-linux_arm</platform>This platform is used to build for Linux ARM;
<platform>-applet</platform>Create the html file and a jar file with all dependencies
 to run the app from a java-enabled browser (the input cannot be a jar file);
<platform>-ios</platform>This platform is used to build for IOS;
<platform>-android</platform>This platform is used to build for Android;
<platform>-all</platform>Single parameter to deploy to all supported platforms;
Options
<platform>/p</platfrom>Package the VM with the application;
<platform>/r</platform>Specify a registration key to be used to activate TotalCross when required;
<platform>/m</platform>Specifies a path to the mobileprovision and certificate store to deploy an ipa file for iOS;
<platform>/a</platform>Assigns the application id; can only be used for libraries or passing a .tcz file;
<platform>/autostart</platform>automatically starts the application after a boot is completed. Currently works for Android only;
<platform>/c</platform>Specify a command line to be passed to the application;
<platform>/i</platform>Install the file after generating it; platforms is a list of comma-separated platforms. Supports: android. E.G.: /i android;
<platform>/k</platform>Keep the .exe and other temporary files during wince generation;
<platform>/kn</platform>As /k, but does not create the cab files for WinCE;
<platform>/n</platform>Override the name of the tcz file with the given name;
<platform>/o</platform> Override the output folder with the given path (defaults to the current folder);
<platform>/t</platform>Just test the classes to see if there are any invalid references. Images are not converted, and nothing is written to disk;
<platform>/v</platform>Verbose output for information messages;
<platform>/w</platform>Waits for a key press if an error occurs;
<platform>/x</platform>Comma-separated list of class names that must be excluded (in a starts-with manner). E.G.: "/x com/framework/".
Build your app
To deploy your application you only need to use a maven execution template by passing the command:mvn package
To deploy by command line you need to be in the folder that contains the jar of your project and pass the parameters of tc.Deploy:
Argument for plataforms to deploy
-win32This argument is used to build for Windows;
-winceThis argument is used to build for Windows CE
-winmo This argument is used to build for Windows Mobile Only;
-linux This argument is used to build for Linux x86 (Debian);
-linux_arm This platform is used to build for Linux ARM;
-applet the html file and a jar file with all dependencies to run the app from a java-enabled browser (the input cannot be a jar file);
-iosThis argument is to build for iOS;
-androidThis argument is to build for Android;
-allSingle parameter to deploy to all supported platforms;
Options
/pPackage the VM with the application;
/rSpecify a registration key to be used to activate TotalCross when required;
/mSpecifies a path to the mobileprovision and certificate store to deploy an ipa file for iOS;
/aAssigns the application id; can only be used for libraries or passing a .tcz file;
/autostartautomatically starts the application after a boot is completed. Currently works for Android only;
/c Specify a command line to be passed to the application;
/iinstall the file after generating it; platforms is a list of comma-separated platforms. Supports: android. E.G.: /i android;
/kKeep the .exe and other temporary files during WinCE generation;
/knAs /k, but does not create the cab files for WinCE;
/n Override the name of the .tcz file with the given name;
/o Override the output folder with the given path (defaults to the current folder);
/t Just test the classes to see if there are any invalid references. Images are not converted, and nothing is written to disk;
/vVerbose output for information messages;
/w Waits for a key press if an error occurs;
/xComma-separated list of class names that must be excluded (in a starts-with manner). E.G.: "/x com/framework/".
See the example below
java -cp "%TOTALCROSS3_HOME%"/dist/totalcross-sdk.jar tc.Deploy HelloTC.jar -android /p /r YOUR_TC_KEY_HERE
"%TOTALCROSS3_HOME%"  is the folder where the TC SDK
HelloTC.jar is the .jar of project
Your apps
After packaging your application the files will be in the project_folder\target\install\
Problems with WinCE? If your Operational System is not Windows or it is Windows and has not Cabwiz program, try to add/kas first platform to  in your pom.xml
Device Simulator
TotalCross SDK
Last modified 1yr ago
Copy link
Contents
Requirements
Deploy
Your apps