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

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

Deploy 환경 설정하기

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

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

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

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

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

실행 환경에 따른 Update Type 선택

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

Update Type

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

실행 환경, 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

넥사크로 앱을 실행하는 데 필요한 프레임워크(nexacrolib) 배포 여부를 설정할 수 있습니다. 실행 환경이 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) 모듈 타입을 표시합니다.

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

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

%USERAPP% Alias 경로 참고

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

프레임워크 파일(nexacrolib.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만 표시합니다.

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

App Builder 관련 문서

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

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

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