App Builder related articles
Server Setup Guide > App Builder
Deployment Guide > App Builder
Development Tools Guide > Build App- Create Installation Files
An "App" is a basic unit used in the App Builder for building apps. You should create an App to build new apps. Moreover, you can change or delete an App in the App Builder. You can build Android, iOS and macOS apps depending on how you configure an App.
Click the [New] button in the menu [BuildApp > App List] and a window for creating a new "App" will be opened.
Enter default settings for the app
The "App" will not be created until you enter the information and click the [Save] or [Build] button.
Description | ||
|---|---|---|
1 | Basic Property | Specify the basic information of the app to be built and the settings required when building. |
2 | Nexacro Library | Specify the library as Nexacro. |
3 | Target OS | Choose the operating system you want to deploy your app on and specify the necessary settings for the building. |
Basic Property
Description | ||
|---|---|---|
1 | Project Name | Enter a name for the project. |
2 | Package Name | Name of the package |
3 | App Title | Name of apps to build |
4 | Project URL | This is the URL where the Nexacro-based app is located. The last slash in the URL must be omitted. |
A package name is used as the identifier of apps to build. Normally, a package name is created by writing a domain name in the opposite way.
eg) com.nexacro
If you create a package name with only one word, an error may occur in the build process.
If you include iOS as a target OS, you must use the same package name as the one that you entered when requesting a provisioning profile.
Nexacro Library
Description | ||
|---|---|---|
Nexacro Library | Selects a Nexacro mobile library. You must choose the library of the same version as the one used in developing the app. |
Click the [+] button to add a new library.
Item | Description | |
|---|---|---|
1 | Name | Enter the library name. |
2 | Version | Enter the library version. |
3 | Owner | Displays the owner information. |
4 | Nexacro Framework File | Uploads the nexacrolib.zip file to be deployed. The uploaded item can be downloaded by clicking with the mouse. |
5 | Version | This is the uploaded Nexacro Framework File version. Checks and displays the version information in the JSON file included in Nexacro Framework File. |
6 | Library File | Uploads the library file. ex) Android : nexacroN_Android_2021xxxx_1.zip iOS : nexacroN_iOS_2021xxxx_1.zip macOS : nexacroN_macOS_2021xxxx_1.zipThe uploaded item can be downloaded by clicking with the mouse.
|
7 | Description | Enter the description of the library. |
Target OS
Select OSes for which apps will be built. You can configure detailed settings for each selected OS. If you attempt to upload resources directly from the management console rather than Nexacro Studio, you should register appropriate JSON files (start_[OS name].json). Then the Nexacro application resource category will print necessary resources, allowing you to upload those resource files.
Clicking the detail button opens a table showing the contents of the JSON file.
Click the [Upload History] button to check the upload history of the resource files.
On macOS, if you select "none" for the Signing Info information, the app build is processed without including the Signing Info. The build will work normally, but you will need to change the security settings when running the app after installing it.
Setting additional options
Just enter the basic settings and you can proceed to building the app. To set additional options for each item, click the [Option +] button at the bottom right, expand the option, and then change the settings.
Basic Property Options
Description | ||
|---|---|---|
1 | Version | Enter the app version to build. |
2 | Build Mode | elects the build mode. If you choose "debug", you can perform debugging by using Android Debug Bridge (adb). |
3 | Detail Error Message | Determines whether to expose the error messages that come out during the loading process |
4 | Deploy | Select or add a deployment server and a server path. Auto Deploy: When an item is selected, the app can be deployed to the deployment server immediately after building. Click the [Deploy] button to deploy the resources to the specified server. Click the [History] button to check the deployment history. Click the [+] button to add information on new deployment servers. |
5 | Owner | Designates the owner of the App (The account holder who has logged in the App builder will be designated as the owner automatically.) |
6 | Access | Authorization to use the App. The items of the App List varies according to the authorization. - share: designated users can use the App. - public: all users can use the App. - private: only the owner can use the App. |
Target OS > Android Options
Category | Description | |
|---|---|---|
1 | Import / Export | Based on the created App, you can export a project that can be edited in Xcode. By contrast, you can import a project that has been edited through Xcode. |
2 | Icon Image File | Designates the image file of the app's icon. If you designate nothing, Nexacro's default image will be applied. You can designate either one compressed file (ZIP format) that contains multiple image files or each image file separately. |
3 | Splash Image File | Designates the file of app's splash image, which appears at the launch of the app. If you designate nothing, Nexacro's default image will be applied. You can designate either one compressed file (ZIP format) that contains multiple image files or each image file separately. |
4 | Splash Scale Type | Set the splash image size. One the following 4 options can be selected. - Adjust the aspect ratio. stretch to fit the screen size - Maintain the aspect ratio. expand without blank area - Maintain the aspect ratio. expand to fit - Original size |
5 | Splash Background color | Specify the background color of the splash area. |
6 | Rotation | In the app, select an option to lock the screen to Portrait or Landscape, or to unlock the screen and activate the sensor. |
7 | Signing Detail | Selects a signature |
8 | User Library | Selects user libraries |
9 | Device API | Selects device API permissions |
Click the [detail] button next to the Icon image and Splash image items to check the set image list.
If you designate a compressed file, you should name the directories and files in the compressed file as defined in the below table.
ic_launcher.png: icon image file
splashimage_phone_landscape.png: splash image file for the landscape orientation
splashimage_phone_portrait.png: splash image file for the portrait orientation
If directories and files are named falsely, the build process may fail. Even if the build process is completed, the app may fail to work properly.
Directory | file name | Image Size(px) |
|---|---|---|
drawable-hdpi | ic_launcher.png | 72x72 |
splashimage_phone_landscape.png | Changing in response to screen sizes | |
splashimage_phone_portrait.png | ||
drawable-ldpi | ic_launcher.png | 36x36 |
splashimage_phone_landscape.png | ||
splashimage_phone_portrait.png | ||
drawable-mdpi | ic_launcher.png | 48x48 |
splashimage_phone_landscape.png | ||
splashimage_phone_portrait.png | ||
drawable-xhdpi | ic_launcher.png | 96x96 |
splashimage_phone_landscape.png | ||
splashimage_phone_portrait.png | ||
drawable-xxhdpi | ic_launcher.png | 144x144 |
splashimage_phone_landscape.png | ||
splashimage_phone_portrait.png | ||
drawable-xxxhdpi | ic_launcher.png | 192x192 |
splashimage_phone_landscape.png | ||
splashimage_phone_portrait.png |
Android Permission
Select permissions for Nexacro device APIs. By clicking the + button, you can open the whole list of the device APIs. After selecting necessary permissions, click the OK button.
You must enter keys additionally when you use the Map and X-PUSH APIs. When you select the permissions for the X-PUSH APIs especially, you must attach a Firebase Android config file (google-services.json).
Target OS > iOS Options
Category | Description | |
|---|---|---|
1 | Import / Export | Based on the created App, you can export a project that can be edited in Xcode. By contrast, you can import a project that has been edited through Xcode. |
2 | Icon Image File | Designates the image file of the app's icon. If you designate nothing, Nexacro's default image will be applied. You can designate either one compressed file (ZIP format) that contains multiple image files or each image file separately. |
3 | Splash Image File | Designates the file of app's splash image, which appears at the launch of the app. If you designate nothing, Nexacro's default image will be applied. You can designate either one compressed file (ZIP format) that contains multiple image files or each image file separately. |
4 | Splash Scale Type | Set the splash image size. One the following 4 options can be selected. - Adjust the aspect ratio. stretch to fit the screen size - Maintain the aspect ratio. expand without blank area - Maintain the aspect ratio. expand to fit - Original size |
5 | Splash Background color | Specify the background color of the splash area. |
6 | Rotation | In the app, select an option to lock the screen to Portrait or Landscape, or to unlock the screen and activate the sensor. |
7 | Signing Detail | Selects a signature |
8 | User Library | Selects user libraries |
Click the [detail] button next to the Icon image and Splash image items to check the set image list.
You should name the icon and splash image files as defined in the below table.
file name | Image Size(px) | Description |
|---|---|---|
Icon.png | 57x57 | Home screen on iPhone/iPod touch (iOS 6.1 and earlier) |
Icon@2x.png | 114x114 | Home screen on iPhone/iPod Touch with retina display (iOS 6.1 and earlier) |
[size].png | 57X57 (57.png) 76X76 (76.png) 120x120 (120.png) 152X152 (152.png) 167X167 (167.png) | |
splashimage_pad_landscape.png | 1024x768 | Splash image file for the landscape orientation in iPad. |
splashimage_pad_portrait.png | 768x1024 | Splash image file for the portrait orientation in iPad. |
splashimage_phone_landscape.png | 960x640 | Splash image file for the landscape orientation in iPhone. |
splashimage_phone_portrait.png | 640x960 | Splash image file for the portrait orientation in iPhone. |
splashimgae_phone5_landscape.png | 1136x640 | Splash image file for the landscape orientation in iPhone. |
splashimgae_phone5_portrait.png | 640x1136 | Splash image file for the portrait orientation in iPhone. |
Target OS > macOS Options
Category | Description | |
|---|---|---|
1 | Import / Export | Based on the created App, you can export a project that can be edited in Xcode. By contrast, you can import a project that has been edited through Xcode. |
2 | Icon Image File | Designates the image file of the app's icon. If you designate nothing, Nexacro's default image will be applied. The extension of the image file is ".icns". |
3 | Splash Image File | Designates the file of app's splash image, which appears at the launch of the app. If you designate nothing, Nexacro's default image will be applied. |
4 | Dmg Image File | Designates the file of an image that appears at the installation of the app. If you designate nothing, Nexacro's default image will be applied. |
5 | Signing Detail | Selects a signature |
Click the [detail] button next to the Icon, Splash, and Dmg image items to check the set image list.
If the dots per inch (DPI) of the designated DMG file is not 72X72, the background image may appear distorted in macOS 10.7 or later.
Generating image files using Target OS > Icon Generate
Click the [Icon Generate] button next to the image file setting screen to run the Icon Generator screen. After selecting the image type to create and uploading the image file, click the [Generate] button to create a compressed file according to the selected target OS. The created file can be downloaded and uploaded for the image setting.
Only the png files are supported for the uploaded images.
Target OS > Export and import project files
If you need functionality that is not supported by App Builder, you can export a created App in the form of a project so that you can add necessary features or edit the project through development tools of each OS. Access the menu [Project Modification] to export the current App as a compressed file or import a project that was edited through another development tool.
Button | Description | |
|---|---|---|
1 | Export | The current App project will be exported as a compressed file. |
2 | Import | A user-modified project will be imported and added to the current App project. |
3 | Revert | The state of the current App project will return to the data saved in App Builder. |
If you click the Import button, the below dialog will appear to prompt you to select either Yes or No. Your selection will decide how to import a modified project.
Selection | Description | |
|---|---|---|
1 | YES | Maintains the state of the imported project, which has been edited through another tool. - Deactivates the configuration windows of each platform of the project. - While you can change the common configuration, the changed settings will not apply to the platform of the imported project. |
2 | NO | Does not maintain the state of the imported project, which has been edited through another tool. - Activates the configuration windows of each platform of the project. - Apps are built with the configuration specified on the console screen of App Builder applied to the imported project. |
Target OS > User Library
You can select a user library that can be used on Android and iOS operating systems or register a new one. On the Options screen, click the [+] button next to the User Library to display a window where you can select a list. After checking the desired library, click the [Add] button.
If you need to add a new library, click the [New] button to register a new one.
Build App
If you try to build apps with a newly created App, the "Start to build" button will appear. When the button is clicked, App Builder starts to build apps for the selected OSes.
When the build operation finishes, results will be displayed. If App Builder successfully builds an app, a link will be created to enable you to download the created app. App Builder allows you to re-build all the apps of selected OSes by clicking the "Rebuild All" button or to re-build a specific app among them.
Description | ||
|---|---|---|
1 | Download | Allows you to download the installation file of the built app. |
2 | QRCode | Displays a URL and QR code that allow you to download the installation file of the built app. |
3 | rebuild | Re-builds the app of the relevant OS. |
4 | build Log | Allows you to check the logs of the process of building the app. |
5 | Last Build Time | Displays the time when the app was last built. |
If you change settings in the management console, you should click the Save button before building apps. Otherwise, the unsaved change will not be applied when apps are built.
Installation files are named according to the below rules. The "App Tile" and "Build mode" options are set in the App Info stage.
Android: [App Title]-[Build mode].apk, [App Title]-[Build mode].aab
iOS, macOS: [App Title].ipa
eg) sample-debug.apk, sample.ipa
App names displayed on mobile devices follow just the value of the App Title option.
You may face a problem if users try to download your app through Google Chrome by scanning a QR code provided by your app. When users scan the QR code to enter the URL for downloading your app, "downloadFile.do" or "downloadFile.htm" is written in the address bar of Chrome. However, the download will not be performed. The below measures are solutions to such a problem.
- Clear cache in Google Chrome
- Update Google Chrome to the latest
The QR codes are not supported in the following cases.
macOS
When the iOS Provisioning profile type is "app-store"
Android App Bundle(.aab) file