19.사용자에게 배포할 설치 파일(또는 웹 문서) 만들기

Edit

배포단계에서는 개발이 완료된 프로젝트는 사용자가 디바이스에 설치하거나 웹브라우저에서 접속해 사용할 수 있는 형태로 만들 수 있습니다. Packing 단계에서는 배포할 실행 환경을 선택하고 업데이트 형태를 지정하면 필요한 파일을 만듭니다. Build App 단계에서는 Packing 단계에서 생성된 파일을 압축해서 설치 파일을 생성할 수 있습니다.

19.1Deploy 환경 설정하기

메뉴 [Deploy > Settings] 항목을 클릭하면 Deploy 관련 필요한 값을 설정할 수 있습니다. 메뉴 [Tools > Options] 항목 중 Deploy 환경 설정과 관련된 항목만 모아놓았으며 설정하는 값은 같습니다.

19.2Packing 단계에서 아카이브 파일 만들기

배포할 프로젝트를 실행할 환경과 업데이트 형태를 선택합니다. 선택한 환경에 따라 아카이브 파일을 만들 때 포함될 항목을 지정할 수 있습니다.

19.2.1Packing 위저드 실행하고 아카이브 파일 만들기

1

메뉴 [Deploy > Packing(Archive&Update)]를 선택하면 Packing 위저드가 실행됩니다.

2

Output Path 항목에서 아카이브 파일을 생성할 기본 위치를 지정합니다.

3

[Next] 버튼을 클릭하면 실행 환경에 따른 Packing 옵션을 선택하는 화면으로 전환됩니다.

4

실행 환경을 선택하고 실행 환경에 따른 Update Type과 설정 옵션을 지정합니다. 아카이브 파일의 압축, 난독화 옵션을 지정하는 경우에는 Options 항목을 선택해 원하는 옵션을 지정합니다.


항목

설명

1

Sub Directory

아카이브 파일을 생성할 폴더를 지정합니다.

선택한 실행 환경에 따라 자동으로 하위 폴더가 생성됩니다.

실행 환경별 하위 폴더는 아래와 같습니다.

Web Browser (_web_)

Windows (_windows_)

Androids (_android_)

iOS (_ios_)

macOS (_macos_)

2

실행 환경

아카이브 파일을 생성할 실행 환경을 선택합니다.

선택한 실행 환경의 설정 옵션을 지정할 수 있습니다.

선택하지 않은 실행 환경의 설정 옵션은 수정할 수 없습니다.

3

Update Type

앱 배포 방식에 따라 3가지 Update Type을 지정합니다.

선택한 Update Type에 따라 설정 옵션이 변경됩니다.

Web Browser 실행 환경은 Update Type을 선택하지 않습니다.

4

Resource Setting

실행 환경별 설정 옵션을 지정합니다.

5

Update Info

Update Info 설정창을 띄웁니다.

6

Options

Deploy 환경 설정창을 띄웁니다.

메뉴 [Deploy > Settings]와 같은 기능입니다.

5

[Packing] 버튼을 클릭하면 선택한 실행 환경과 설정에 따라 아카이브 파일을 만들고 결과를 표시합니다.

성공적으로 아카이브 파일이 만들어졌다면 해당 폴더를 파란색 링크로 표시합니다. 링크를 클릭하면 만들어진 폴더를 띄워줍니다. 왼쪽 하단의 [Build] 버튼을 클릭하면 설치 파일을 만드는 Build App 화면으로 이동합니다. 실행 환경을 Web Browser만 선택한 경우에는 [Build] 버튼이 활성화되지 않습니다.

index.html

Web Browser 실행 환경은 별도의 설치 파일을 만들지 않고 웹브라우저에서 접근할 수 있는 HTML 파일을 만듭니다. _web_ 폴더에 index.html 파일을 포함해 서버에 업로드해야 하는 파일이 생성된 것을 확인할 수 있습니다. _web_ 폴더에 있는 파일을 모두 서버에 업로드하면 웹브라우저에서는 아래와 같이 앱에 접근할 수 있습니다.

http://[도메인 주소]/index.html

19.2.2실행 환경에 따른 Update Type 선택

실행 환경이 Windows, Android, iOS, macOS인 경우에는 Update Type 항목을 선택할 수 있습니다. 선택한 Update Type 항목에 따라 선택할 수 있는 설정 옵션이 달라지며 생성되는 아카이브 파일이 달라집니다.

Update Type

앱에 따라 Update Type 항목이 Local인 경우에도 데이터를 조회하거나 서버에 연결할 필요가 있는 경우 네트워크 연결이 필요할 수 있습니다.

19.2.3실행 환경, Update Type에 따른 설정 옵션

실행 환경, Update Type에 따라 배포할 대상을 설정할 수 있습니다. 설정 옵션 항목에서 배포할 파일을 선택하거나 추가할 수 있습니다.

Module, Source, Resource 업데이트 시 Version 정보가 이전에 배포한 파일의 Version 정보와 같다면 실제 구동 시 같은 파일로 판단하고 업데이트를 진행하지 않습니다.

Update Info

최신 콘텐츠를 서버에서 받아서 처리하는 업데이트 정책을 지정할 수 있습니다. 콘텐츠를 받아올 경로를 지정하고 일정 횟수 정해진 시간만큼 업데이트를 시도하다가 콘텐츠를 받지 못하면 실패로 처리합니다. 업데이트를 자동으로 처리할지 사용자 요청 시 처리할지도 지정할 수 있습니다.

실행 환경, Update Type 별 설정 옵션 여부


Update (Local + Server)

Server

Local

Web Browser

X

Windows

O (필수)

O (필수)

X

Android

O (필수)

O (필수)

X

iOS

O (필수)

O (필수)

X

macOS

O (필수)

O (필수)

X

설정 옵션

Resource Setting 항목 오른쪽에 있는 [Update Info] 항목을 클릭하고 내용을 편집합니다.

항목

설명

Base URL

SetupResource.zip, SetupRuntime.exe 등 업데이트가 필요한 파일의 기본 접근 경로

Timeout

대기시간

Retry

재시도 횟수

AutoUpdate

auto, manual 중 선택

Update Info 항목은 필수 항목이며 체크를 해제할 수 없습니다.

Setup

Build App 위저드를 사용하지 않고 넥사크로플랫폼 기본 Setup을 배포할 수 있습니다. 부트스트랩 파일과 리소스 파일만 생성하며 부트스트랩 정보에 Setup 업데이트 정보가 추가됩니다.

실행 환경, Update Type 별 설정 옵션 여부


Update (Local + Server)

Server

Local

Web Browser

X

Windows

O

O

O

Android

X

X

X

iOS

X

X

X

macOS

X

X

X

설정 옵션

배포할 운영체제 타입을 선택합니다. 선택한 항목에 대한 정보는 부트스트랩 파일(start.json)에 추가됩니다.

항목

설명

Use

배포할 운영체제 선택

Type

운영체제 타입

Server Path

Update Info 항목에서 설정한 Base URL 상대 경로

Setup 배포 경로가 Base URL과 다른 경우 지정합니다.

예를 들어 Base URL 항목은 "UPDATE"로 지정하고 Server Path 항목을 "SETUP_FILE"로 지정한 경우에는 아래와 같이 접근합니다.

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

Setup Filename

Setup 파일명

Engine Setup Key

Setup Key

Version

Setup 버전 정보

Setup 설정 옵션을 선택하고 바로가기 아이콘이나 스플래시 이미지를 수정하거나 엔진 셋업키를 변경하기 원한다면 Build App 단계에서 변경할 수 있습니다.

Module

넥사크로플랫폼 앱을 실행하는 데 필요한 프레임워크(nexacro17lib) 배포 여부를 설정할 수 있습니다. 실행 환경이 Windows라면 외부 모듈이나 UWP API 앱 실행을 위한 모듈을 추가할 수 있습니다.

실행 환경, Update Type 별 설정 옵션 여부


Update (Local + Server)

Server

Local

Web Browser

X

Windows

O

O

O (필수)

Android

O

X

O (필수)

iOS

O

X

O (필수)

macOS

O

X

O (필수)

설정 옵션

배포할 모듈 파일을 추가하거나 변경, 삭제할 수 있습니다. 실행 환경에 따라 설정 옵션 중 일부만 제공될 수 있습니다.

항목

설명

Type

모듈 타입

확장 모듈의 경우 운영체제 버전을 표시합니다 (Ext [운영체제버전])

프레임워크(nexacrolib), 파일(File), UWP(UWP) 모듈 타입을 표시합니다.

Server Path

Update Info 항목에서 설정한 Base URL 상대 경로

모듈 배포 경로가 Base URL과 다른 경우 지정합니다.

예를 들어 Base URL 항목은 "UPDATE"로 지정하고 Server Path 항목을 "MODULE"로 지정한 경우에는 아래와 같이 접근합니다.

http://localhost/UPDATE/MODULE/[module file name]

Name

모듈 파일명 (변경할 수 없음)

TargetPath

로컬 환경에 파일을 내려받는 경로를 지정합니다.

기본 설정(./)으로 지정한 경우에는 %USERAPP% 경로에 파일을 저장합니다.

%USERAPP%Component/TEST/ 와 같은 식으로 특정 경로를 지정할 수도 있습니다.

Version

모듈 버전

Description

기타 메모 (시스템 실행에는 영향을 미치지 않습니다).

설정 옵션 (Update Type이 Local인 경우)

프레임워크 파일(nexacro17lib.zip)이 기본 설정되어 있으며 삭제하거나 변경할 수 없습니다. 설정 옵션 항목은 Type, Name 두 가지 값만 표시합니다.

설정 옵션 (실행 환경이 Windows인 경우)

확장 모듈, UWP, 파일을 추가하는 기능을 사용할 수 있습니다. 실행 환경이 Android, iOS, macOS인 경우에는 프레임워크 파일 외 다른 모듈 파일을 배포할 수 없습니다.

설정 옵션 (실행 환경이 Web Browser 또는 Update Type이 Server인 경우)

프레임워크 파일을 압축된 파일 형태로 내려받지 않고 Web Browser에서 실행되는 파일 형태로 배포합니다.

Source

프로젝트 파일 중에서 배포할 대상을 선택합니다. 최초 배포 시에는 전체 프로젝트를 선택해야 하며 업데이트 시에는 필요한 대상만 선택하고 배포할 수 있습니다. 실행 환경과 Update Type에 따라 파일을 직접 배포하거나 압축된 아카이브 파일 형태로 배포합니다.

실행 환경, Update Type 별 설정 옵션 여부


Update (Local + Server)

Server

Local

Web Browser

O

Windows

O

O

O (필수)

Android

O

O

O (필수)

iOS

O

O

O (필수)

macOS

O

O

O (필수)

설정 옵션

Project Files 항목에서 배포 대상 파일을 선택합니다. Archives 항목이 있는 경우에는 소스 파일을 담을 아카이브 파일을 선택한 후에 Project Files 항목에서 배포 대상을 선택할 수 있습니다.

항목

설명

Rearchive

체크박스를 선택해 원하는 소스 아카이브 파일만 생성할 수 있습니다.

Name

아카이브 파일명

Version

아카이브 파일 버전

Description

기타 메모 (시스템 실행에는 영향을 미치지 않습니다).

설정 옵션 (실행 환경이 Web Browser 또는 Update Type이 Server인 경우)

아카이브 파일을 만들지 않고 Project Files에서 선택한 항목만 배포합니다. 설정 옵션에서 Archives 항목이 표시되지 않습니다.

설정 옵션 (Update Type이 Local인 경우)

설정 옵션 항목은 Rearchive, Name 두 가지 값만 표시합니다.

Resource

리소스 파일 중에서 배포할 대상을 선택합니다. 최초 배포 시에는 전체 리소스를 선택해야 하며 업데이트 시에는 필요한 대상만 선택하고 배포할 수 있습니다. 실행 환경과 Update Type에 따라 파일을 직접 배포하거나 압축된 아카이브 파일 형태로 배포합니다.

실행 환경, Update Type 별 설정 옵션 여부


Update (Local + Server)

Server

Local

Web Browser

O

Windows

O

O

O (필수)

Android

O

O

O (필수)

iOS

O

O

O (필수)

macOS

O

O

O (필수)

설정 옵션

Resource Files 항목에서 배포 대상을 선택합니다. Archives 항목이 있는 경우에는 Resource.zip 하나의 파일만 만들 수 있습니다.

항목

설명

Name

아카이브 파일명 (변경할 수 없음)

Version

아카이브 파일 버전

Description

기타 메모 (시스템 실행에는 영향을 미치지 않습니다).

설정 옵션 (실행 환경이 Web Browser 또는 Update Type이 Server인 경우)

아카이브 파일을 만들지 않고 Resource Files에서 선택한 항목만 배포합니다. 설정 옵션에서 Archives 항목이 표시되지 않습니다.

설정 옵션 (Update Type이 Local인 경우)

설정 옵션 항목은 Name만 표시합니다.

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

Packing 단계에서 생성한 아카이브 파일 중에서 설치 시 필요한 파일을 포함해 설치 파일을 만들 수 있습니다. 배포할 운영체제에 따라 옵션을 지정할 수 있습니다.

19.3.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 파일로 저장합니다.

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

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

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

Setting > Build Environment > Target Project

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

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

Build 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에 설치된 라이브러리 파일을 사용합니다.

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

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

Setting > Android, iOS > Advanced > User Library

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


항목

설명

1

사용자 라이브러리 목록

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

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

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

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

2

사용자 라이브러리 속성

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

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

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

안드로이드 : *.jar

iOS : *.a

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

Permission 지정하기

Setting > Android > Advanced > Permission

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

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

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

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

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

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

19.4UWP API 앱 만들고 실행하기

윈도우 10 이상 운영체제에서 유니버설 윈도우 플랫폼(UWP, Universal Windows Platform) API를 사용하는 앱을 생성하고 배포할 수 있습니다. DeviceAPI 중에서 Camera, Network, Geolocation 오브젝트 중 일부 기능을 지원합니다.

19.4.1Packing > Module

Module 설정 시 "UWP (Windows10 Device Agent)" 항목을 추가합니다.

Packing 설정 시 Update Type이 "Local"인 경우에는 UWP API 앱을 지원하지 않습니다.

19.4.2nexacro17_UWP.appxbundle 파일 배포

nexacro17_UWP.appxbundle 파일은 설치 파일에 포함되지 않으며 Packing 단계에서 생성되지 않습니다. 해당 파일은 BootStrap URL 위치에 직접 복사해주어야 합니다. 사용자가 설치된 앱 실행 시 자동으로 nexacroUWP가 설치됩니다.

19.4.3UWP API 앱 실행

Network나 Geolocation 오브젝트를 사용하는 경우에는 기존 앱과 다르지 않습니다. 다만 Camera 오브젝트에서 takePicture 메소드처럼 디바이스의 장비를 직접 실행하는 경우에는 아래와 같이 백그라운드 앱이 실행됩니다.

간단하게 윈도우 10 운영체제에 설치된 카메라를 실행하고 캡쳐한 이미지를 ImageViewer 컴포넌트에 보여주는 예제입니다.

this.Button00_onclick = function(obj:nexacro.Button,e:nexacro.ClickEventInfo)
{
    this.Camera00.takePicture();
};

this.Camera00_oncapture = function(obj:nexacro.Camera,e:nexacro.CameraEventInfo)
{
    trace('camera capture ok: '+e.url);
    this.ImageViewer00.set_image("file://"+e.url);
};

this.Camera00_onerror = function(obj:nexacro.Camera,e:nexacro.CameraErrorEventInfo)
{
    trace('camera error: '+e.errormsg);
};