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.
메뉴[BuildApp > App List] 항목에서 [New] 버튼을 클릭하면 새로운 "App"을 생성할 수 있는 창이 나타납니다.
앱 기본 설정값 입력하기
정보를 입력하고 [Save] 또는 [Build] 버튼을 클릭하기 전에는 "App"이 생성되지 않습니다.
項目 | 説明 | |
|---|---|---|
1 | Basic Property | 빌드할 앱 기본 정보와 빌드 시 필요한 설정을 지정합니다. |
2 | Nexacro Library | 넥사크로 라이브러리를 지정합니다. |
3 | Target OS | 앱을 배포할 대상 운영체제를 선택하고 빌드 시 필요한 설정을 지정합니다. |
Basic Property
Description | ||
|---|---|---|
1 | Project Name | 앱 프로젝트 이름을 입력합니다. |
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 Platform-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 Platform mobile library. You must choose the library of the same version as the one used in developing the app. |
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.
[Upload Histroy] 버튼을 클릭하면 리소스 파일 등을 업로드한 이력을 확인할 수 있습니다.
macOS에서 Siging Info 정보를 "none" 항목으로 선택한 경우 Signing Info를 포함하지 않고 앱 빌드를 처리합니다. 빌드는 정상적으로 동작하지만 앱 설치 후 실행 시 보안 관련 설정을 변경해주어야 합니다.
추가 옵션 설정하기
기본 설정값만 입력하면 앱 빌드 작업까지 진행할 수 있습니다. 각 항목별로 추가적인 옵션을 설정하려면 항목 오른쪽 아래에 있는 [Option +] 버튼을 클릭하고 옵션 항목을 펼친 후에 설정할 수 있습니다.
Basic Property Options
Description | ||
|---|---|---|
1 | Version | 빌드할 앱 버전을 입력합니다. |
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 | 디플로이 서버와 서버 경로를 선택하거나 추가합니다. Auto Deploy: 항목 선택 시 빌드 후 바로 디플로이 서버에 배포할 수 있습니다. [Deploy] 버튼 클릭 시 지정한 서버에 리소스를 배포합니다. [History] 버튼 클릭 시 디플로이 이력을 확인할 수 있습니다. [+] 버튼 클릭 시 새로운 디플로이 서버 정보를 추가할 수 있습니다. |
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 Platform'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 Platform'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 | Rotation | 앱에서 화면을 세로(Portrait) 또는 가로(Landscape) 로 고정시키거나 고정을 풀고 센서를 활성화(Sensor) 하는 옵션을 선택합니다. |
5 | Signing Detail | Selects a signature |
6 | User Library | Selects user libraries |
7 | Device API | Selects device API permissions |
Icon 이미지와 Splash 이미지 항목 옆에 [detail] 버튼을 클릭하면 설정한 이미지 목록을 확인할 수 있습니다.
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 Platform 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 Platform'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 Platform'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 | Rotation | 앱에서 화면을 세로(Portrait) 또는 가로(Landscape) 로 고정시키거나 고정을 풀고 센서를 활성화(Sensor) 하는 옵션을 선택합니다. |
5 | Signing Detail | Selects a signature |
6 | User Library | Selects user libraries |
Icon 이미지와 Splash 이미지 항목 옆에 [detail] 버튼을 클릭하면 설정한 이미지 목록을 확인할 수 있습니다.
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) |
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 Platform'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 Platform'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 Platform's default image will be applied. |
5 | Signing Detail | Selects a signature |
Icon, Splash, Dmg 이미지 항목 옆에 [detail] 버튼을 클릭하면 설정한 이미지 목록을 확인할 수 있습니다.
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.
Target OS > Icon Generate를 사용해 이미지 파일 생성하기
이미지 파일 설정 화면 옆에 [Icon Generate] 버튼을 클릭하면 Icon Generator 화면이 실행됩니다. 생성할 이미지 Type을 선택하고 이미지 파일을 업로드한 후 [Generate] 버튼을 클릭하면 선택한 Target OS에 따라 압축파일을 생성합니다. 생성한 파일은 내려받아 업로드해서 이미지를 설정할 수 있습니다.
업로드하는 Image 파일은 png 확장자만 지원합니다.
Target OS > 프로젝트 파일 내보내고 가져오기
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
Android, iOS 운영체제에서 사용할 수 있는 User Library를 선택하거나 새로 등록할 수 있습니다. Options 화면에서 User Library 항목 옆에 있는 [+| 버튼을 클릭하면 목록을 선택할 수 있는 창이 표시되고 원하는 라이브러리 항목을 체크한 후 [Add] 버튼을 클릭합니다.
새로 라이브러리를 추가해야 한다면 [New] 버튼을 클릭해서 새로운 항목을 등록할 수 있습니다.
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
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