¶ 프로젝트 실행
Morpheus plugin 에서는 안드로이드, iOS를 통한 프로젝트 실행을 지원합니다. 프로젝트를 실행하는 방법으로는 Application Editor의 개요 탭을 이용하는 방법이 있습니다.
-
Application Editor의 개요 탭 실행 그룹에서 원하는 실행 방법을 선택합니다.
-
실행 버튼을 안드로이드는 연결되어 있는 디바이스, iOS는 디바이스 리스트를 선택하여 실행이 됩니다.
¶ 안드로이드
- 연결되어 있는 디바이스, 시뮬레이터를 타겟으로 앱을 실행합니다. ( 여러개일경우에는 첫번째 연결된 디바이스를 타겟으로 실행 )
- 실행시 이미지와 같이 빌드 타입을 선택할수 있습니다.
¶ iOS
- 연결되어 있는 디바이스 리스트가 표기되고 선택하여 앱을 실행합니다.
¶ 실행
- 실행시 각각 task가 실행되며 관련 내용들을 확인할수 있습니다.
¶ 프로젝트 내보내기
또한 Morpheus plugin 에서는 안드로이드 APK AAB, 리소스 배포를 지원합니다. 프로젝트를 배포하는 방법으로는 Application Editor의 내보내기 그룹을 사용하는 방법이 있습니다.
-
Application Editor의 내보내기 그룹의 내보내기 방법을 선택할수 있습니다.
¶ 1. 안드로이드 APK/AAB 내보내기
¶ 1) 내보내기
-
APK 내보내기와 AAB 내보내기는 배포파일을 생성하는 과정은 동일하며 최종적으로 각각 apk 파일과 aab 파일이 생성됩니다.
-
내보내기 버튼을 선택하면 각각 task가 실행되고 andorid/app/build/outputs 폴더 밑에 파일이 생성이 됩니다.
¶ 2) 안드로이드 Keystore 설정
-
배포되는 앱에 서명을 위한 Keystore는 gradle.properties 파일에 내용을 설정하여 사용하게 됩니다.
¶ 터미널(명령어)로 만들기
1. 터미널 열기
- Windows: 명령 프롬프트(cmd) 또는 PowerShell
- Mac/Linux: 터미널 앱
2. keytool 명령 사용하기
- keytool은 Java 설치 시 포함된 프로그램
예시 명령어:
keytool -genkeypair \
-v \
-keystore my-release-key.jks \
-alias my_key_alias \
-keyalg RSA \
-keysize 2048 \
-validity 10000 \
-storepass 000000 \
-keypass 000000 \
-dname "CN=홍길동, OU=부서, O=회사, L=도시, ST=도/시, C=KR"
각 부분 설명:
- keystore my-release-key.jks = my-release-key.jks 파일 이름으로 키를 저장.
- alias my_key_alias = 키를 부르는 별명(alias) = my_key_alias
- keyalg RSA와 -keysize 2048 = 암호 방식과 길이
- validity 10000 = 유효기간(일 단위). > 예시는 약 27년정도
- storepass = 비밀번호 설정(KeyStore password)
- keypass = 보통 서명키별 비밀번호(key password)
- dname = 이름, 조직, 도시, 국가코드등을 입력(영문)
- 정보 입력이 끝나면 my-release-key.jks 파일이 생성됨.
- Keystore를 생성하는 다양한 방법은 아래 링크 가이드를 참고하여 생성하시면 됩니다. (https://wiki.uracle.co.kr/madp/client/guide/android_signing_build#앱-서명키-생성하기)
주의) keystore는 사용자의 기기에 설치된 apk에 서명하는 데 사용하는 키로, 앱 서명이 변경된 배포 파일은 동일한 앱으로 인식되지 않아 새로운 앱으로 별도로 설치해야 하므로 반드시 생성한 keystore파일과 암호 등의 정보를 안전하게 백업해 두시기 바랍니다.
¶ 2. 리소스 내보내기
본 기능은 리소스 업데이트 기능을 사용하여 업데이트를 지원하는 앱이 리소스 업데이트가 있을 경우 서버에 등록하기 위한 리소스 파일을 배포하기 위한 기능 입니다.
- 리소스 배포를 선택하면 아래 그림처럼 리소스들의 리스트가 표기가 됩니다.
- 내보내기에 포함될 파일을 선택하고 적용 버튼을 클릭합니다.
- 파일을 내보내려는 경로를 선택하고 save 버튼을 누르면 설정한 경로에 리소스 업데이트 서버에 올릴 수 있는 압축 파일이 생성됩니다.
