Build App 단계에서 설치 파일 만들기
Packing 단계에서 생성한 아카이브 파일 중에서 설치 시 필요한 파일을 포함해 설치 파일을 만들 수 있습니다. 배포할 운영체제에 따라 옵션을 지정할 수 있습니다.
Build App 위저드 실행하고 설치 파일 만들기
1
Packing 위저드에서 아카이브 파일을 만들고 [Build] 버튼을 클릭하거나 메뉴 [Deploy > Build App]를 선택하면 Build App 위저드가 실행됩니다.
Packing 단계에서 [Build] 버튼을 클릭한 경우에는 속성 설정화면으로 넘어가고 Build App 메뉴로 접근한 경우에는 Build Target 선택 후 설정 화면으로 이동합니다.
2
Build Target 항목 중 Windows 운영체제를 선택한 경우에 Setup 관련 설정을 확인하고 [Build] 버튼을 클릭합니다.
항목 | 설명 |
|---|---|
Program Name | 프로그램 추가/삭제에서 표시되는 프로그램 명입니다.기본값은 프로젝트명으로 설정합니다. |
Build Type | |
Build Type | 운영체제 버전을 선택합니다. |
Setup information | |
Install Location | 앱 설치 파일 실행 시 앱이 설치될 경로를 지정합니다. 운영체제 "Program Files" 폴더 아래에 설치될 경로를 지정할 수 있습니다. 기본값은 "TOBESOFT\Nexacro N\21\{program Name}"입니다. |
Windows [운영체제 버전] | |
32비트, 64비트 중에서 선택한 운영체제 정보만 설정합니다. 실행 환경에 따라 설치 파일명을 변경할 수 있습니다. | |
Setup Filename | 생성할 설치 파일명을 지정합니다. |
Setup Version | 설치 파일 버전을 지정합니다. |
Windows [운영체제 버전] > Configure - Server Path나 Engine Setup Key 변경 시 설정합니다. | |
Server Path | Update Info 항목에서 설정한 Base URL 상대 경로 Setup 배포 경로가 Base URL과 다른 경우 지정합니다. 예를 들어 Base URL 항목은 "UPDATE"로 지정하고 Server Path 항목을 "SETUP_FILE"로 지정한 경우에는 아래와 같이 접근합니다.
|
Engine Setup Key | 엔진 설치 키 (clsid)를 지정합니다. |
항목 | 설명 |
|---|---|
Advanced | |
Install Mode | Default: 기본 설치 모드 Silent: 설치 중 대화상자가 나타나지 않고 기본 설정값으로 설치 |
Auto Update | Packing 단계에서 Update Info에 설정한 AutoUpdate 설정보다 우선해서 넥사크로 엔진 자동 업데이트 여부를 지정합니다. 기본값은 "Auto"입니다. "Manual" 항목 지정 시 넥사크로 엔진 자동 업데이트를 처리하지 않습니다. |
Shortcut Type | Desktop : 바탕화면에 바로가기 아이콘을 생성합니다. Start Menu : 시작메뉴에 바로가기 아이콘을 생성합니다. Desktop + Start Menu : 바탕화면과 시작메뉴에 바로가기 아이콘을 생성합니다. Select at Install time: 엔진 설치 시 바로가기 아이콘 생성 위치를 지정합니다. No use : 바로가기 아이콘을 생성하지 않습니다. 기본값은 "Select at Install time"입니다. Install Mode 옵션값이 "Silent"인 경우에는 "Select at Install time"를 사용할 수 없으며 기본값은 "Desktop"입니다. |
Shortcut Icon File | 앱 설치 파일, 실행 및 삭제 프로그램의 아이콘을 변경합니다. 기본값은 넥사크로 아이콘을 사용합니다. |
Splash Image File | 스플래시 화면 이미지를 지정한 파일로 변경합니다. |
Splash Show Message | Default : 기본 메시지 표시 Do not show: 메시지를 표시하지 않음 |
Update Browser | 브라우저 에뮬레이션을 최신 버전으로 업데이트할지를 설정합니다. |
Rename Executable | 실행 프로그램 파일명을 변경합니다. 기본값은 "nexacro.exe"입니다. |
Only One | 같은 키 값을 가진 앱을 중복 실행하지 않도록 설정합니다. |
앱에서 WebBrowser 컴포넌트를 사용하는 경우 Update Browser 옵션으로 설정한 값에 따라 실행되는 브라우저 에뮬레이션 버전이 달라집니다. 사용자 PC에 2개 이상의 앱이 설치된 경우 Update Browser 옵션이 다르면 앱 간의 설정 충돌이 발생할 수 있습니다.
Rename Executable 옵션에서 기본값인 "nexacro.exe" 대신 다른 이름으로 파일명을 지정하면 설치된 앱 간의 설정 충돌을 방지할 수 있습니다.
기본 Engine Setup Key를 그대로 사용하거나 입력칸 오른쪽에 있는 열쇠 모양의 버튼을 클릭하면 Engine Setup Key를 새로 생성할 수 있습니다. 사용자 PC에 여러 개의 앱이 설치되어야 하는 경우에는 Engine Setup Key를 새로 생성하고 따로 관리하는 것을 권장합니다.
업데이트 과정에서 Engine Setup Key를 새로 생성하면 설치된 앱을 업데이트할 수 없습니다.
3
Build Target 항목 중 Android, iOS, macOS 운영체제를 선택한 경우에 AppBuilder 관련 옵션을 설정합니다.
항목 | 설명 |
|---|---|
Project information | |
Program Name | 운영체제에 앱 설치 시 표시되는 프로그램명입니다. |
Build Environment | |
TargetProject | 앱빌더 프로젝트를 신규로 생성하거나 기존에 있는 앱빌더 프로젝트를 선택합니다. |
Project URL | 앱을 배포할 URL을 지정할 수 있습니다. 기본값은 AppBuilder에서 자동생성되는 URL입니다. |
Package Name | Package 이름을 표시합니다. |
Version | 파일 버전을 지정합니다. |
Build Type | - Build 선택한 프로젝트를 새로 빌드합니다. 이미 빌드한 경우에는 다시 빌드합니다. - Upload Contents 선택한 프로젝트의 콘텐츠만 업로드합니다. |
Build Library | 프로젝트 빌드 시 적용할 넥사크로 라이브러리를 선택합니다. |
Build Mode | 빌드 모드를 선택합니다. |
Auto Deploy Server | |
Deploy Mode | Deploy 서버 사용 여부를 설정합니다. true 선택 시 Deploy Server를 선택할 수 있습니다. |
Deploy Server | Deploy Mode 항목값을 true 선택 시 앱빌더에 설정한 Deploy Server 목록에서 Deploy 서버를 선택합니다. |
Deploy Directory | Deploy Server에 설정된 경로를 표시합니다. 설정값은 수정할 수 있습니다. |
[운영체제] | |
Setup Filename | 생성할 설치 파일명을 지정합니다. |
Setup Version | 설치 파일 버전을 지정합니다. |
[운영체제 > Advanced] | |
Signing | 프로젝트 빌드 시 적용할 Signing 정보를 지정합니다. |
Plist URL | In-House 업데이트를 처리하기 위한 plist URL 정보를 지정합니다. AppBuilder 서버를 사용하는 경우에는 기본값을 사용하며 별도 배포 서버를 운영하는 경우에 URL 값을 변경할 수 있습니다. iOS에서만 사용합니다. |
Built-in Library | 빌드 시 적용할 32비트, 64비트 공유 라이브러리를 선택합니다. |
User Library | 프로젝트 빌드 시 적용할 User Library를 선택합니다. Android, iOS만 지원하며 macOS는 지원하지 않습니다. |
Icon | 앱 아이콘 이미지 파일을 지정합니다. |
Splash | - Splash Image 앱 실행 시 표시되는 Splash 이미지 파일을 지정합니다. - Scale Type Splash 이미지 크기를 설정합니다. 아래 4가지 옵션 중 하나를 선택할 수 있습니다. > Adjust the aspect ratio. stretch to fit the screen size : 화면 비율 조정. 화면 크기에 맞게 stretch 처리 > Maintain the aspect ratio. expand without blank area : 화면 비율 유지. 빈 영역 없이 확장 처리 > Maintain the aspect ratio. expand to fit : 화면 비율 유지. 크기에 맞게 확장 > Original size : 원본 이미지 크기 - Background Color Splash 영역 배경 색상을 지정합니다. |
Dmg Image | Apple disk image (DMG) 배경 이미지 파일을 지정합니다. macOS에서만 사용합니다. |
Permission | 앱 실행 권한을 지정합니다. Android만 지원하며 iOS, macOS는 지원하지 않습니다. |
Rotation | 앱에서 화면을 세로(Portrait) 또는 가로(Landscape) 로 고정시키거나 고정을 풀고 센서를 활성화(Sensor) 하는 옵션을 선택합니다. |
아이콘, 이미지 파일
운영체제에 따라 지정된 형식에 맞는 파일을 지정해주어야 합니다.
Icon이나 Splash Image 등 이미지 파일을 포함하고 있는 경우에 눈 모양 아이콘 클릭 시 이미지 미리보기 기능을 제공합니다. zip 파일로 여러 이미지 파일을 묶은 경우 오른쪽 아래 [>] 버튼을 클릭해 다음 이미지를 확인할 수 있습니다.
4
[Build] 버튼을 클릭하면 설정에 따라 설치 파일을 생성합니다.
설치 파일 생성이 완료되면 생성된 파일을 확인할 수 있습니다. 운영체제 또는 파일에 따라 QR 코드가 지원되는 경우에는 산출물 선택 시 QR 코드 이미지가 표시되며 그렇지 않으면 산출물 URL만 제공합니다. 빌드 실패 시에는 빨간색으로 표시되며 표시합니다.
항목 | 설명 | |
|---|---|---|
1 | Log | 앱 빌더에서 처리한 작업 로그를 표시합니다. 오류가 발생한 경우에는 오류 메시지를 표시합니다. |
2 | Download url | 배포 대상 환경별 설치 파일을 내려받을 수 있는 URL을 표시합니다. 마우스 포인터를 가져가면 오른쪽에 QR 코드 이미지가 표시됩니다. |
3 | Copy url | Download url 값을 클립보드에 복사합니다. |
4 | Save QR Code | QR Code 이미지를 PNG 파일로 저장합니다. |
AppBuilder 실행 시 추가 옵션 처리하기
AppBuilder에서 앱 빌드 작업을 실행하려면 앱빌더 프로젝트를 생성하고 프로젝트 옵션을 지정해주어야 합니다. 프로젝트를 생성하고 옵션을 지정하는 작업은 AppBuilder 콘솔에서 처리할 수 있습니다. 그 중에서 앱빌더 프로젝트를 생성하거나 프레임워크 라이브러리를 변경하고 사용자 라이브러리를 등록하고 권한을 지정하는 작업은 Build App 위저드에서 처리할 수 있습니다.
TargetProject (앱빌더 프로젝트) 생성하기
Setting > Build Environment > Target Project
앱빌더를 사용하기 위해서는 앱빌더 프로젝트를 생성해주어야 합니다. 이미 생성된 프로젝트가 있다면 해당 프로젝트를 선택해서 사용할 수 있습니다. 프로젝트가 없는 경우에는 [+] 버튼을 클릭해 프로젝트를 생성합니다.
Package Name과 Signing 설정에 등록된 내용이 다른 경우에는 설치 파일 생성이 실패할 수 있습니다.
Build Library를 신규로 등록하거나 변경하기
Setting > Build Environment > Build Library
넥사크로 프레임워크 라이브러리와 운영체제별 라이브러리를 관리합니다. 기존에 등록된 항목을 선택하거나 변경할 수 있으며 신규로 라이브러리 파일을 등록할 수 있습니다.
항목 | 설명 | |
|---|---|---|
1 | 라이브러리 목록 | 앱빌더 서버에 등록된 라이브러리와 신규로 등록하려는 라이브러리 목록을 표시합니다. 상태에 따라 수정중인 항목과 새로 추가한 항목은 아이콘을 다른 형태로 표시합니다. |
2 | 라이브러리 속성 | Name, Version, Framework Library는 필수항목입니다. Mobile Engine Library는 3개 항목 중 하나 이상은 지정해주어야 합니다. |
서버에 등록된 라이브러리 대신 local library 항목을 지정한 경우에는 PC에 설치된 라이브러리 파일을 사용합니다.
local libray 항목은 제품 설치 버전으로 기본 설정됩니다. 기본으로 설정된 라이브러리 파일 목록은 SetupRuntime.json 파일에서 확인할 수 있습니다.
기본 설정된 라이브러리 파일은 사용자가 변경할 수 있습니다. 변경된 내용은 제품 업데이트 전에는 유지되며 제품 업데이트 시 SetupRuntime.json 파일이 변경되면 해당 버전에 맞게 초기화됩니다.
프레임워크 라이브러리와 다른 버전의 파일을 선택할 수 있습니다. 파일 버전이 다른 경우에는 빨간색으로 항목을 표시합니다.
Singning 신규로 등록하거나 변경하기
Setting > Android, iOS, macOS > Advanced > Signing
Signing 파일을 등록하거나 생성(Android의 경우)하고 등록된 내용을 확인할 수 있습니다.
Android
항목 | 설명 | |
|---|---|---|
1 | name | 등록할 항목 이름을 입력합니다. |
2 | Owner | Keystore(또는 Signing)의 소유자를 입력합니다. (로그인 계정으로 자동 입력됩니다). |
3 | Keystore Alias Name | Keystore Alias 이름을 입력합니다. Keystore Alias 이름은 6자 이상으로 입력해야 합니다. |
4 | Keystore Alias Password | Keystore Alias의 비밀번호를 입력합니다. Keystore Alias 비밀번호는 6자 이상으로 입력해야 합니다. |
5 | Keystore File | Keystore 파일을 생성하거나 가지고 있는 파일을 등록합니다. - Generate: App Builder에서 Keystore 파일을 생성합니다. - Upload: Keystore 파일을 등록하고 등록된 파일을 표시합니다. 등록된 파일은 링크 형태로 표시되며 링크를 클릭하면 해당 파일을 내려받을 수 있습니다. |
6 | Keystore Password | Keystore 비밀번호를 입력합니다. |
iOS/macOS
항목 | 설명 | |
|---|---|---|
1 | name | 등록할 항목 이름을 입력합니다. |
2 | Owner | Keystore(또는 Signing)의 소유자를 입력합니다. (로그인 계정으로 자동 입력됩니다). |
3 | Certificate Name | iOS Certificate 이름을 입력합니다. |
4 | Certifcate Password | 등록한 iOS Certificate 파일 비밀번호를 입력합니다. |
5 | Certificate File | iOS Certificate 파일을 등록합니다. |
6 | Provisioning Profile (iOS) | Provisioning Profile 파일을 등록합니다. |
7 | Provisioning Type | Provisioning Profile 파일 유형을 표시합니다. 입력 항목은 아니고 Provisioning Profile 파일 속성에 따라 enterprise , app-store , ad-hoc , development 중 한 가지가 표시됩니다. |
User Library를 신규로 등록하거나 변경하기
Setting > Android, iOS > Advanced > User Library
운영체제별 사용자 라이브러리를 관리합니다. 기존에 등록된 항목을 선택하거나 변경할 수 있으며 신규로 사용자 라이브러리 파일을 등록할 수 있습니다.
항목 | 설명 | |
|---|---|---|
1 | 사용자 라이브러리 목록 | 앱빌더 서버에 등록된 사용자 라이브러리와 신규로 등록하려는 사용자 라이브러리 목록을 표시합니다. |
2 | 사용자 라이브러리 속성 | 모든 항목이 필수 입력 항목입니다. (ClassName은 안드로이드 운영체제인 경우에만 입력합니다). 지원하는 라이브러리 파일의 확장자는 아래와 같습니다. 안드로이드 : *.jar iOS : *.a |
프로젝트 빌드 시 적용할 사용자 라이브러리를 선택해 적용할 수 있습니다.
Permission 지정하기
Setting > Android > Advanced > Permission
안드로이드 운영체제에서 필요한 권한을 지정할 수 있습니다.
Map, Xpush 권한 지정 시에는 Key값을 입력해주어야 합니다. key값이 없는 경우에 앱이 정상적으로 동작하지 않습니다.
Xpush 권한 지정 시에는 Firebase Android 구성 파일(google-services.json)을 첨부해주어야 합니다.
AppBuilder 빌드 실패 시 로그 정보 확인하기
AppBuilder에서 빌드 처리 중 실패한 경우 로그 파일을 확인할 수 있습니다. 빌드 실패 시 설치 파일 링크 대신 로그 파일을 확인할 수 있는 링크를 제공합니다.
로그 파일에서는 에러코드와 빌드 실패 시 생성된 로그 정보를 확인할 수 있습니다.
이전 설정 그대로 빠르게 Build 하기
프로젝트의 Build 이력이 있는 경우에는 Quick Build 기능을 사용할 수 있습니다. Build 이력이 있는 경우에는 메뉴 [Deploy > Quick Build] 항목이 활성화됩니다.
Quick Build Wizard에서는 Build를 진행한 운영체제별 목록을 확인하고 앱을 내려받거나 수정된 Resource 파일의 Version 정보를 수정하고 Build를 진행할 수 있습니다.
항목 | 설명 | |
|---|---|---|
1 | History | 운영체제별 Build 이력을 표시합니다. Setup File을 내려받을 수 있는 링크와 QR Code 정보를 제공합니다. 선택한 운영체제만 Build를 실행합니다. |
2 | Detail | Packing, Build Wizard에서 설정한 일부 설정값을 표시합니다. 내용은 수정할 수 없고 확인 용도로만 사용할 수 있습니다. |
3 | 버튼 클릭 시 Detail 창을 닫거나 펼칠 수 있습니다. | |
4 | Contents Update | 업데이트할 Resource를 선택하고 Version 정보를 수정합니다. 선택한 Resource만 처리합니다. |
5 | Packing | Packing 위자드를 실행합니다. |
6 | Build | Quick Build를 실행합니다. Update Type에 따라 내부적으로 처리하는 동작이 달라집니다. |
[Build] 버튼 클릭 시 Update Type에 따라 아래와 같이 동작합니다.
Update (Local + Server) | Server | Local | |
|---|---|---|---|
Windows | Packing | Packing | Packing Build |
Android iOS macOS | Packing Upload Contents | Packing | Packing Build |