App Builder 관련 문서
서버 설정/개발 가이드 > App Builder
앱 배포 가이드 > App Builder
개발도구 가이드 > Build App 단계에서 설치 파일 만들기
App Builder 설치 이후 관리 콘솔에 접속해 App Builder 사용을 위한 설정을 진행합니다. 관리 콘솔에 접속하면 로그인 창이 표시됩니다. 최초 로그인 시 ID는 "admin", Password는 "admin"입니다. Password는 로그인 후 메뉴[User]에서 변경할 수 있습니다.
App Builder 환경 설정을 위해 관리 콘솔에서 메뉴[Configuration > Server Configuration] 항목을 선택합니다. 해당 메뉴는 4가지로 구분되어 있습니다. General 항목을 제외한 나머지 항목은 체크박스에서 사용 여부를 선택할 수 있습니다.
항목 | 설명 | |
|---|---|---|
1 | General | JDK 경로와 생성된 앱 프로젝트를 관리할 경로를 지정합니다. |
2 | iOS & macOS Configuration | iOS, macOS SDK 정보를 표시합니다. |
3 | In-house Distribution | In-house 배포 설정 시 관련 정보를 지정합니다. |
4 | Android Configuration | Android SDK 설치 경로를 지정합니다. |
General
General 항목은 기본적으로 작성해야 하는 항목입니다.
항목 | 설명 | |
|---|---|---|
1 | JDK Path | JDK 설치 경로를 지정합니다. |
2 | Work Path | 앱 프로젝트를 생성하고 업로드한 리소스 파일을 저장할 작업 경로를 지정합니다. |
3 | Language | UI 표시 언어를 설정합니다. 한국어, 영어, 중국어를 지원합니다. |
iOS & macOS Configuration
iOS, macOS 앱을 빌드하기 위한 설정입니다.
Xcode와 관련 SDK가 정상적으로 설치된 경우라면 관련 설정을 자동으로 확인하고 설정값을 표시합니다. 설정값이 표시되지 않는 경우에는 Xcode나 SDK가 정상적으로 설치되었는지 확인합니다.
항목 | 설명 | |
|---|---|---|
1 | Login Keychain Password | 로그인 키체인 비밀번호를 입력합니다. |
2 | Developer Directory | Xcode developer directory를 표시합니다. |
3 | Xcode Version | 설치된 Xcode 버전을 표시합니다. |
4 | Xcode Build Version | Xcode 빌드 버전을 표시합니다. |
5 | SDK Details | 설치된 관련 SDK 상세 정보를 표시합니다. |
In-house Distribution
In-house Distribution이란 Apple App Store를 사용하지 않고 자체적으로 설치파일을 배포할 수 있는 서버를 사용하는 것입니다. 해당 기능을 사용하기 위해서는 HTTPS 설정이 되어 있어야 하며 공인된 도메인으로 발급받은 서버 인증서가 갖춰져야 합니다.
In-house Distribution 항목이 설정된 경우에는 앱 빌드 시 .ipa 파일과 .plist 파일을 설정된 서버로 전송합니다. 빌드된 앱을 내려받을 때 설정한 Host 정보를 적용합니다.
항목 | 설명 | |
|---|---|---|
1 | Host Name(IP) | 서버 호스트명 또는 IP 정보를 입력합니다. |
2 | Port | 파일 전송을 위한 Port 정보를 입력합니다. |
3 | Login ID | 서버 접속 시 로그인 ID를 입력합니다. |
4 | Password | 서버 접속 시 로그인 Password를 입력합니다. |
5 | Target URL | 복사된 .ipa , .plist 파일을 참조하게 될 URL을 입력합니다. |
6 | Target Directory | 복사된 .ipa , .plist 파일이 위치하게 경로를 입력합니다. |
Target URL 항목에 입력된 URL과 실제 파일을 내려받기 위해 접속하는 URL은 다릅니다. Target URL 항목은 .ipa, .plist 파일이 실제 저장된 경로이며 파일을 내려받을때는 빌드 후 제공되는 URL에 접속해 설치 파일을 내려받습니다.
HTTPS 설정이 되어 있지 않거나 공인된 도메인으로 발급받은 서버 인증서가 없는 경우에는 "In-house Distribution" 기능을 통해 앱 설치를 할 수 없습니다. 이런 경우에는 "In-house Distribution" 기능을 사용하지 않고 .ipa 파일을 PC에 내려받은 후 Xcode 또는 애플 아이튠즈를 통해 앱을 설치해야 합니다.
Android Configuration
항목 | 설명 | |
|---|---|---|
1 | SDK Path | Android SDK가 설치된 경로를 지정합니다. |
SDK Path 항목 설정 후 설치된 Android SDK 목록이 표시되지 않는 경우에는 아래 사항을 확인합니다.
Android SDK가 정상적으로 설치되었는지 확인
설치된 Android SDK Path를 정확하게 지정했는지 확인
Android SDK Manager 를 실행해 Android 13(API 33)이 설치되었는지 확인