8.Build App 단계에서 설치 파일 만들기

Edit

8.1Build 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" 폴더 아래에 설치될 경로를 지정할 수 있습니다.

기본값은 "nexacro\17"입니다.

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"로 지정한 경우에는 아래와 같이 접근합니다.

http://localhost/UPDATE/SETUP_FILE/[setup file name]

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"입니다.

앱에서 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비트 공유 라이브러리를 선택합니다.

17.0.0.2200 이후 버전에서 지원하는 기능입니다.

User Library

프로젝트 빌드 시 적용할 User Library를 선택합니다.

Android, iOS만 지원하며 macOS는 지원하지 않습니다.

Icon

앱 아이콘 이미지 파일을 지정합니다.

Splash Image

앱 실행 시 표시되는 Splash 이미지 파일을 지정합니다.

Dmg Image

Apple disk image (DMG) 배경 이미지 파일을 지정합니다.

macOS에서만 사용합니다.

Permission

앱 실행 권한을 지정합니다.

Android만 지원하며 iOS, macOS는 지원하지 않습니다.

아이콘, 이미지 파일

운영체제에 따라 지정된 형식에 맞는 파일을 지정해주어야 합니다. 사용할 수 있는 파일에 대한 정보는 아래 링크를 참고하세요.

4

[Build] 버튼을 클릭하면 설정에 따라 설치 파일을 생성합니다.

설치 파일 생성이 완료되면 생성된 파일을 확인할 수 있습니다. iOS, Android 운영체제의 경우 사용자가 직접 파일을 내려받을 수 있도록 QR 코드를 생성해주며 Windows, macOS 운영체제의 경우 생성된 설치 파일을 확인할 수 있습니다.


항목

설명

1

Log

앱 빌더에서 처리한 작업 로그를 표시합니다.

오류가 발생한 경우에는 오류 메시지를 표시합니다.

2

Download url

배포 대상 환경별 설치 파일을 내려받을 수 있는 URL을 표시합니다.

마우스 포인터를 가져가면 오른쪽에 QR 코드 이미지가 표시됩니다.

3

Copy url

Download url 값을 클립보드에 복사합니다.

4

Save QR Code

QR Code 이미지를 PNG 파일로 저장합니다.

8.2AppBuilder 실행 시 추가 옵션 처리하기

AppBuilder에서 앱 빌드 작업을 실행하려면 앱빌더 프로젝트를 생성하고 프로젝트 옵션을 지정해주어야 합니다. 프로젝트를 생성하고 옵션을 지정하는 작업은 AppBuilder 콘솔에서 처리할 수 있습니다. 그 중에서 앱빌더 프로젝트를 생성하거나 프레임워크 라이브러리를 변경하고 사용자 라이브러리를 등록하고 권한을 지정하는 작업은 Build App 위저드에서 처리할 수 있습니다.

8.2.1TargetProject (앱빌더 프로젝트) 생성하기

Setting > Build Environment > Target Project

앱빌더를 사용하기 위해서는 앱빌더 프로젝트를 생성해주어야 합니다. 이미 생성된 프로젝트가 있다면 해당 프로젝트를 선택해서 사용할 수 있습니다. 프로젝트가 없는 경우에는 [+] 버튼을 클릭해 프로젝트를 생성합니다.

Package Name과 Signing 설정에 등록된 내용이 다른 경우에는 설치 파일 생성이 실패할 수 있습니다.

8.2.2Build Library를 신규로 등록하거나 변경하기

Setting > Build Environment > Build Library

넥사크로 플랫폼 프레임워크 라이브러리와 운영체제별 라이브러리를 관리합니다. 기존에 등록된 항목을 선택하거나 변경할 수 있으며 신규로 라이브러리 파일을 등록할 수 있습니다.


항목

설명

1

라이브러리 목록

앱빌더 서버에 등록된 라이브러리와 신규로 등록하려는 라이브러리 목록을 표시합니다. Status 항목은 3가지로 상태를 표시합니다.

server : 서버에 등록된 라이브러리

update : 서버에 등록된 라이브러리를 사용자가 편집하고 있는 상태

new : 사용자가 신규로 등록한 라이브러리

2

라이브러리 속성

Name, Version, Framework Library는 필수항목입니다.

Mobile Engine Library는 3개 항목 중 하나 이상은 지정해주어야 합니다.

3

Open Library Folder

라이브러리 파일이 있는 경로를 윈도우 탐색기로 열어줍니다.

기본 경로는 아래와 같습니다.

C:\Program Files (x86)\nexacro\17\SetupRuntime

서버에 등록된 라이브러리 대신 local library 항목을 지정한 경우에는 PC에 설치된 라이브러리 파일을 사용합니다.

8.2.3Singning 신규로 등록하거나 변경하기

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 파일을 등록합니다.

8.2.4User Library를 신규로 등록하거나 변경하기

Setting > Android, iOS > Advanced > User Library

운영체제별 사용자 라이브러리를 관리합니다. 기존에 등록된 항목을 선택하거나 변경할 수 있으며 신규로 사용자 라이브러리 파일을 등록할 수 있습니다.


항목

설명

1

사용자 라이브러리 목록

앱빌더 서버에 등록된 사용자 라이브러리와 신규로 등록하려는 사용자 라이브러리 목록을 표시합니다. Status 항목은 3가지로 상태를 표시합니다.

server : 서버에 등록된 사용자 라이브러리

update : 서버에 등록된 사용자 라이브러리를 사용자가 편집하고 있는 상태

new : 사용자가 신규로 등록할 사용자 라이브러리

2

사용자 라이브러리 속성

모든 항목이 필수 입력 항목입니다.

(ClassName은 안드로이드 운영체제인 경우에만 입력합니다).

지원하는 라이브러리 파일의 확장자는 아래와 같습니다.

안드로이드 : *.jar

iOS : *.a

프로젝트 빌드 시 적용할 사용자 라이브러리를 선택해 적용할 수 있습니다.

8.2.5Permission 지정하기

Setting > Android > Advanced > Permission

안드로이드 운영체제에서 필요한 권한을 지정할 수 있습니다.

Map, Xpush 권한 지정 시에는 Key값을 입력해주어야 합니다. key값이 없는 경우에 앱이 정상적으로 동작하지 않습니다.

Xpush 권한 지정 시에는 Firebase Android 구성 파일(google-services.json)을 첨부해주어야 합니다.

8.3AppBuilder 빌드 실패 시 로그 정보 확인하기

AppBuilder에서 빌드 처리 중 실패한 경우 로그 파일을 확인할 수 있습니다. 빌드 실패 시 설치 파일 링크 대신 로그 파일을 확인할 수 있는 링크를 제공합니다.

로그 파일에서는 에러코드와 빌드 실패 시 생성된 로그 정보를 확인할 수 있습니다.