이 문서는 Android 장치에서 Defold 어플리케이션을 빌드하고 실행하는 방법에 대해 설명합니다.
Android 개발은 컨텐츠를 자유롭게 장치에 업로드 하고 액세스 할 수 있다는 점에서 iOS 개발과 다르며 아주 쉽게 게임의 버전을 빌드하고 Android 장치에 복사할 수 있습니다. 또한 와이파이를 통해 장치에서 반복적인 개발을 위한 개발용 엔진(development engine)도 쉽게 추가할 수 있습니다.
Android는 앱을 설치하기 위해 디지털 서명을 필요로 합니다. Apple에서 모든 인증서를 발행하는 iOS와는 달리, Android는 자체 서명된 앱을 허용하므로 앱을 서명하는데 필요한 키나 인증서를 자유롭게 생성할 수 있습니다.
인증서나 키를 생성하는 과정은 복잡해 보일 수 있지만, 개발단계에서는 Defold가 이 과정을 완전히 자동화 합니다. 에디터에서 Android 어플리케이션 번들을 만들 때, 당신은 특정 인증서와 키를 제공할 수 있지만, 제공하지 않더라도 Defold가 무작위로 인증서와 키를 생성하고 .apk(Android Application Package) 파일을 서명합니다.
Google Play에 앱을 릴리즈할 때가 되면 앱을 서명하는데 사용되는 실제 인증서와 키를 생성해야만 합니다. 그 이유는 이 앱의 버전을 배포하고 업데이트 하려 할 때, 엡데이트 된 .apk 파일과 현재 버전이 동일한 서명으로 되어있어야 하기 때문입니다. 만약 서로 다른 private key로 서명하면, Google Play는 .apk 업데이트를 거부(reject)하게 되고 당신은 이 게임을 완전히 새로운 앱으로 다시 배포해야 합니다.
더 많은 정보는 Google Play developer console 에서 찾을 수 있습니다. 나만의 인증서와 키를 생성하는 방법은 아래 정보를 참고 바랍니다.
adb 명령 줄 도구는 Android 장치와 상호작용하는데 사용되는 다재다능한 프로그램이며 사용하기도 쉽습니다. Mac, Linux, Windows용으로 Android SDK package 에서 adb를 다운로드하고 설치할 수 있습니다.
http://developer.android.com/sdk/index.html 에서 Android SDK 를 다운로드하세요.
On Ubuntu Linux:
$ sudo apt-get install android-tools-adb
On Fedora 18/19:
$ sudo yum install android-tools
On macOS (Homebrew)
$ brew install android-platform-tools
adb로 USB를 통해 컴퓨터와 Android 장치가 연결되었는지 확인하려면 아래 커맨드를 입력하십시오.
$ adb devices
List of devices attached
31002535c90ef000 device
장치(device)가 나타나지 않으면, Android에서 USB 디버깅(USB debugging) 이 활성화 되어 있는지 확인하세요. 설정(Settings) 에서 개발자 옵션(Developer options) (또는 Development)에서 찾을 수 있습니다.
Defold 엔진의 stand-alone 버전은 준비된 .apk 파일을 무선으로 장치에 설치하고 반복적인 개발을 가능하게 해 줍니다.
이 파일을 다운로드 한 후, .apk가 있는 위치에서 아래의 adb 명령을 실행합니다.
$ adb install dmengine.apk
4445 KB/s (8706017 bytes in 1.912s)
pkg: /data/local/tmp/dmengine.apk
Success
이제 개발용 “dmengine” 앱이 기기에 설치 되었습니다.
Android 장치에서 게임을 실행하려면, dmengine 앱과 에디터가 동일한 와이파이 네트워크에 연결되어 있어야 합니다.
게임이 실행되는 동안, 평소처럼 핫 리로드을 사용할 수 있습니다.
에디터는 게임을 위한 standalone 어플리케이션 번들을 쉽게 만들 수 있게 해 줍니다. Project > Bundle… > Android Application… 메뉴를 선택해 보세요.
인증서와 비공개 키(Private Key)를 선택하고 Package 버튼을 누르면 컴퓨터에서 번들이 생성될 위치를 지정하라는 창이 뜹니다.
에디터는 Android 어플리케이션 번들인 .apk 파일을 생성합니다. 이 파일은 adb 도구를 사용해 기기로 복사하거나 Google Play developer console 을 통해서 Google Play에도 복사할 수 있습니다. game.project 프로젝트 설정 파일에서 버전 코드나 앱에서 사용할 아이콘 등을 지정할 수 있습니다.
엔진의 디버그 모드 버전(번들 생성시에 “Release mode”를 체크 해제 했을 경우)으로 빌드된 번들은 모든 콘솔 출력(console output)을 Android 시스템 로그로 보냅니다. 이 로그는 adb 도구에 “logcat” 명령어를 사용해서 액세스 할 수 있으며 태그(“-s [tagname]”)를 사용해서 출력을 필터링 할 수도 있습니다.
$ adb logcat -s "defold"
--------- beginning of /dev/log/system
--------- beginning of /dev/log/main
I/defold ( 6210): INFO:DLIB: SSDP started (ssdp://192.168.0.97:58089, http://0.0.0.0:38637)
I/defold ( 6210): INFO:ENGINE: Defold Engine 1.2.50 (8d1b912)
I/defold ( 6210): INFO:ENGINE: Loading data from:
I/defold ( 6210): INFO:ENGINE: Initialised sound device 'default'
I/defold ( 6210):
D/defold ( 6210): DEBUG:SCRIPT: Hello there, log!
...
pem 포멧의 인증서와 pk8 포멧의 키를 생성해야 합니다. 이는 openssl 도구를 사용해 생성할 수 있습니다.
$ openssl genrsa -out key.pem 1024
$ openssl req -new -key key.pem -out request.pem
$ openssl x509 -req -days 9999 -in request.pem -signkey key.pem -out certificate.pem
$ openssl pkcs8 -topk8 -outform DER -in key.pem -inform PEM -out key.pk8 -nocrypt
이렇게 해서 어플리케이션 번들을 서명하는데 사용되는 “certificate.pem” 및 “key.pk8” 파일이 생성됩니다.
인증서와 키가 안전하게 저장되었는지 확인하십시오. 만약 이 파일들을 잃어버리면 Google Play에 .apk 업데이트 버전의 파일을 다신 업로드 할 수 없게 됩니다.
장치와 컴퓨터가 동일한 와이파이 네트워크에 있는지 확인합니다. 또한 “dmengine” 앱이 에디터와 동일한 버전인지도 확인합니다. 만약 에디터가 업그레이드 되었다면, “dmengine.apk”도 새로 다운로드해서 장치에 설치해야 합니다.
Android는 새 인증서로 앱을 설치하려는 것을 감지합니다. 디버그용 빌드로 번들을 생성할 때, 각 빌드는 임시 인증서로 서명됩니다. 새 버전을 설치하기 전에 기존 앱을 제거 하십시오.
$ adb uninstall com.defold.examples
Success
$ adb install Defold\ examples.apk
4826 KB/s (18774344 bytes in 3.798s)
pkg: /data/local/tmp/Defold examples.apk
Success
Did you spot an error or do you have a suggestion? Please let us know on GitHub!
GITHUB