창작에 관련된 질문이나 간단한 팁, 예제를 올리는 곳
Love2d의 안드로이드 포트는 알파 단계입니다.
차차 개선되어 나가긴 하겠지만 아직 불안정한 부분이 많으며, 일어날 수 있는 오작동과 그로 인한 결과는 일절 책임지지 않습니다.
이 문서는 Windows 사용자 기준입니다.
Linux나 Mac을 사용할 정도의 내공이 있으신 분들은 자신의 OS에 무언가가 필요할 경우 구글 등으로 검색해서 지혜를 찾아내는 혜안이 있으실 것이므로
Windows 사용자 기준으로 문서를 작성합니다.
0. 앞서
Love2d 안드로이드를 빌드하기 위해서는 PC와는 또 다른 개발환경이 필요하다.
PC처럼 그냥 exe 파일이랑 합체! 하면 좋겠지만 안드로이드는 그렇게 되지 않는다.
그래서 소스 코드를 받아서 빌드해야 한다.
안드로이드 개발에 대해 하나도 몰라도 상관없다.(나도 모른다.) 남이 만든거 컴파일만 하면 되는 거니까.
그냥 .love 파일을 핸드폰에서 돌리고 싶다면 그냥 최신 버전의 apk 파일을 받아 설치하면 된다.
( https://bitbucket.org/MartinFelis/love-android-sdl2/downloads )
그러나 '나는 내 게임으로 apk를 만들어서 올릴거야!' 라는 야망을 가지신 분들은 게임 이름, 버전 정보, 아이콘 등을 바꿔야 하므로 빌드를 새로 하고
약간의 수정 사항을 거쳐야 한다.
1.개발 환경 구축
일단 빌드하기 위한 개발 환경을 구축한다.
그냥 안드로이드 개발환경이라 cocos2d-x 등과 그닥 차이 없다.
만일 이미 상기의 개발환경을 갖추고 있다면 아래의 것들이 설치되어 있는지, 설정이 제대로 되어 있는지 정도만 확인하면 충분하겠지만
그런거 없는 사람들은 따라하면서 개발환경을 구축하자.
1-1. Java SDK(JDK) 설치
http://www.oracle.com/technetwork/java/javase/downloads/index.html
여기에서 자기 버전에 맞는거 찾아 다운로드해서 설치하면 된다.
약관에 동의해야 다운로드 받을 수 있고, 그 다음은 다음다음 넥스트 OK의 연속.
1-2. Ant 설치
http://ant.apache.org/bindownload.cgi
Current Release of Ant 부분으로 가서(Ctrl+F로 찾으면 됨) .zip archive 를 받아준다.
( http://apache.mirror.cdnetworks.com//ant/binaries/apache-ant-1.9.4-bin.zip )
다운로드받아서 압축파일을 C:\ant 경로에 풀어준다.
당연히 없을테니 만든다.
1-3. Android SDK 설치
http://developer.android.com/sdk/index.html
우리는 안드로이드 스튜디오 그런거 필요 없다. 따라서 아래쪽의 SDK Tools Only 부분으로 가서 받는다.
( http://dl.google.com/android/installer_r24.0.1-windows.exe )
설치 다음다음.
1-3-1. Android SDK 패키지 설치
공식 문서에서는 이렇게 설치하라고 한다.
Android SDK Platform-tools API 19.0.1
Android SDK Build-Tools API 19.0.1 (or API 19.0.2, it doesn't matter)
SDK Platform Android 4.4.2 API 19
ARM EABI v7a System Image API 19
Google APIs ARM System Image API 19
Sources for Android SDK API 19
Android Support Library
Google USB driver
가급적 위의 버전으로 설치하자.
Android SDK Platform-tools 등의 경우 19.0.1 버전이 없을 수 있는데 그럼 그냥 요령껏 19 설치하던지, 최신 버전 설치하던지.
1-4. Android NDK 설치
r10 이상의 버전에서는 빌드 오류가 발생하니 r9d 버전을 설치하자.
http://dl.google.com/android/ndk/android-ndk-r9d-windows-x86_64.zip (64비트 사용자는 이쪽)
http://dl.google.com/android/ndk/android-ndk-r9d-windows-x86.zip (32비트 사용자는 이쪽)
자기 OS에 맞는 것 다운받아서 c:\ndk에 압축 해제하자.
고생했다. 이제 개발도구 설치는 끝났다.
2. 소스코드 다운로드받기
git따위 쓰지 않는다, 나는 야매니까!
다운로드 링크 https://bitbucket.org/MartinFelis/love-android-sdl2/downloads 로 가면 Download repository가 있다. 받아준다.
c:\love_android에 압축을 풀었다.
3. 환경변수 설정
윈도우키+Pause를 누르거나 내컴퓨터-우클릭-속성 누른다.
좌측의 고급 시스템 설정을 눌러준다.
고급 탭으로 가서 맨 아래의 환경변수.. 버튼을 누른다.
시스템 변수(S)에서 새로만들기를 눌러준다.
아래의 값들을 추가하자.
이름: ANT_HOME
값: C:\ant
이름: JAVA_HOME
값: C:\Program Files\Java\jdk1.8.0_25 (JDK 버전이 다르면 경로가 달라질 수 있으니 내가 어디에다 설치했는지 한번 확인해보자.)
이름: ANDROID_SDK
값: C:\Program Files\Android\android-sdk (설치 경로가 여기가 맞는지 확인해보자.)
이름: ANDROID_HOME
값: ANDROID_SDK랑 똑같음.
이름: ANDROID_NDK
값: C:\ndk
이름: ANDROID_SWT
값: %ANDROID_SDK%\tools\lib\x86 (64비트 사용자는 %ANDROID_SDK%\tools\lib\x86_64 를 입력.)
그리고 Path를 선택, 편집 버튼을 누른 뒤 아래의 값을 덧붙인다.
;%ANT_HOME%\bin;%ANDROID_SDK%\tools;%ANDROID_NDK%
4. ndk-build 실행
명령 프롬포트를 실행한 뒤 cd c:\love_android 명령을 실행하여 소스를 받아놓은 곳으로 간다.
이후 ndk-build 실행.
멀티코어라면 좀 더 효율적인 작업을 위해 --jobs 명령어를 사용할 수 있다.
ndk-build --jobs 3 식으로. 숫자는 코어수 +1을 의미한다.
듀얼코어라면 코어 2개+1이니까 3이고, 쿼드코어라면 코어 4개+1이니까 5 넣어주면 될 것이다.
싱글코어는 그런거 없다. 그냥 ndk-build.
시간이 좀 걸리고, 기다리면 된다.
5. ant 실행
ant debug 명령어를 실행한다.
모든 것이 성공적이라면 c:\love_android\bin\love_android_sdl2-debug.apk 가 생겼을 것이다.
빌드 성공!
만약 아이콘을 바꾸거나 AndroidManifest.xml을 수정하게 된다면 위의 과정을 모두 거칠 필요는 없고
그냥 ant debug만 다시 해주면 된다.
구글 Play Store에 게임을 내기 위해서는 이 apk 파일에 서명을 해야 하는데 (keystore)
이에 대한 내용은 http://blog.naver.com/norubal29a/22020266816 링크를 참조하길 바란다.
다음 글에서는 소스를 수정하여 엔진이 아닌 자신의 게임을 apk로 만드는 방법에 대해 다루어 보겠다.