[💬] SDL2 프로젝트를 안드로이드로 포팅하기

[Akssus(akssus)]

  오늘 반나절을 이거 가지고 씨름 했음. 뭐가 이렇게 설치하고 설정할게 많은지; 에러는 또 얼마나 많이 나는지...

일단 내가 까먹지 않기 위한 용도기도 한데

공홈에서는 자세히 안 알려주는 포팅법을 혹시 SDL로 게임 만드는 사람 있으면 도움 되라고 한번 정리해봤음.

SDL2 안드로이드 포팅하기

1. 안드로이드 스튜디오를 설치한다. SDK매니저 쓰기 위함인데 그냥 SDK만 따로 관리할 수 있으면 스튜디오까지 안깔아도 됨

 SDK매니저로 SDK 넘버링이 15인거 받는다. 버전이 4.0.3인가 그럴거임. SDL2소스 내의 mk파일에선 최소버전 10 타겟버전 12로 되있는데 이걸로 하면 빌드가 안되더라고 

2. 자바 안 깔려 있으면 자바를 깐다

3. https://developer.android.com/ndk/index.html 에서 NDK를 설치한다. 설치 폴더는 바로 C드라이브 밑으로 하길 추천 

4. http://ant.apache.org/bindownload.cgi 에서 아파치 ant를 깐다. 복잡한 빌드 과정을 일괄처리 해주는 프로그램 깔거 겁나 많네 ㅅㅂ;;;

5. 다 깔았으면 환경 변수 설정을 해줘야 한다. 어떻게 하는지 모르면 검색 ㄱ
   JAVA_HOME = 자바폴더 (통상 C:\Program Files\Java\jdk_x.y.z)
   ANDROID_HOME = 안드로이드 SDK 설치된 폴더( 안드 스튜디오의 SDK매니저로 깔았으면 C:\Users\Administrator\AppData\Local\Android\Sdk )
   ant, ndk-build 커맨드 라인 명령을 쓰기 위해서  path에 ant폴더/bin 과 ndk폴더 를 추가해주자

6. http://android-sdk.en.lo4d.com/download/mirror-ex1 에서 구버전 안드로이드 SDK를 받는다. 
   압축 풀고 나서 보면 tools 폴더에 ant폴더가 있을것이다. ant폴더만 복사해서 원래 sdk폴더의 tools폴더 안에 복사해주자. 
   왜 SDK를 또 받냐고? SDK매니저로 받거나 신버전으로 받은 SDK는 sdk/tools/ant 폴더에 들어있는 build.xml이 없다. 

   이러면 빌드가 안된다. ㅅㅂ 이게 말이야 방구야. 그냥 하자.

   이제 준비물은 다 준비했다. 이제 빌드 설정하러 가자 휴

7. https://www.libsdl.org/download-2.0.php 에서 Source Code를 받자. 안드로이드 포팅할땐 이미 빌드된 lib는 쓸수가 없다 ㅠ

   압축을 풀고 나온 갖가지 파일들 중 android-project 폴더를 통째로 복사해서 빌드를 진행할 폴더에 복사해주자. 여기선 C:\test\android-project 로 하겠음
   안드로이드 프로젝트 폴더 안에는 jni, res, src 폴더가 있을것인데 jni가 바로 우리의 C++ 소스코드가 들어갈 폴더이다. (Java Native Interface의 약자랜다)

8. jni 폴더 안에 SDL2폴더를 생성한 후 방금 받은 소스코드를 싸그리 집어넣는다. 안팎이 뒤집힌 꼴이 된다.
   SDL2_image 라이브러리를 쓰는경우 SDL_image의 소스코드를 받은 후 똑같이 jni 안에 SDL2_image 폴더를 만들어 안에 다 박아넣는다.

9. jni/src 폴더가 바로 우리가 코딩한 소스코드들이 들어갈 폴더다. 프로젝트 폴더 안에도 src가 있고 jni 폴더 안에도 src가 있으니 혼동 주의
   SDL로 이미지 하나 띄우는 프로그램이든 머든 암거나 넣자 난 main.cpp로 해서 넣었음

10. jni/src 폴더안의 android.mk를 열자. android.mk 파일이 여기도 있고 저기도 있으니까 폴더를 잘 봐야됨

    SDL_PATH := ../SDL 를 SDL_PATH := ../SDL2로 바꾼다. 
    SDL_image를 쓰는 경우
    LOCAL_C_INCLUDES := $(LOCAL_PATH)/$(SDL_PATH)/include 를
    LOCAL_C_INCLUDES := $(LOCAL_PATH)/$(SDL_PATH)/include $(LOCAL_PATH)/../SDL2_image 로 바꾸고
    LOCAL_SHARED_LIBRARIES := SDL2 를
    LOCAL_SHARED_LIBRARIES := SDL2 SDL2_image 로 바꿔준다
    공백 띄우고 경로 하나 추가한 것 뿐임

    LOCAL_SRC_FILES := $(SDL_PATH)/src/main/android/SDL_android_main.c \ 줄 아래에 main.cpp라고 써준다. 

    컴파일 할 소스코드 리스트임

11. jni/Application.mk를 연다. 아무 라인에나 NDK_TOOLCHAIN_VERSION=4.9 를 추가해주자. 안 그러면 컴파일 할때 컴파일러 문제 때문에 에러70인가 뭐시기가 뜬다.
    추가로 STL를 사용하기 위해 APP_STL := stlport_static 라인도 추가해준다.

이 시점에서 ndk-build가 될 것이다. cmd에서 폴더로 간 후 ndk-build라고 쳐주자. 

그럼 갖가지 .c들을 컴파일 하고 제대로 성공 했다면 android-project 폴더에 목적파일들과 src 안에는 java파일이 생성 될 것이다. 
만약 에러가 났다면 jni/src/Android.mk 파일 안의 
APP_ABI := armeabi armeabi-v7a x86를
APP_ABI := armeabi armeabi-v7a 로 바꿔주자

다른 에러가 났다면 알아서 구글링 하시고.. 성공 했다면 축하한다. 빌드 1단계는 무사히 끝냈다 ㅎㅎㅎ (너무 힘들다)

12. 이제 jni에서 나와서 프로젝트 폴더에서 좀 작업을 해야한다... AndroidMenifest.xml를 연다. 
 <uses-sdk android:minSdkVersion="10" android:targetSdkVersion="12" /> 라인이 있을 것인데
 <uses-sdk android:minSdkVersion="15" android:targetSdkVersion="15" /> 로 바꿔준다. 10이든 12든 빌드가 안된다고 쉽창

13. ant.properties를 열어 target=android-15 라인을 추가해준다

14. local.properties 파일을 생성해서( 아무 빈 properties 파일 복사해서 이름만 바꾸면 됨 ) 
     sdk.dir = ../../Users/Administrator/AppData/Local/Android/Sdk 를 추가해서 SDK 경로를 추가하는데... 

     이게 베이스 폴더가 프로젝트 폴더라서 그냥 절대경로 하면 

     C:\test\android-project\C:\test\... 

     이런식의 경로가 되버린다. 

     그래서 C:\까지 가서 SDK 폴더 경로를 타고 가야 하는 이상한 모양새가 됨 ㅠ 하여간 SDK 경로 설정하는 부분이니까 알아서 하시고

15. android-project/src/org/libsdl/app 폴더로 가서 SDLActivity.java를 연다.
  protected String[] getLibraries() {
    return new String[] {
          "SDL2",
          //"SDL2_image",
          //"SDL2_mixer",
          //"SDL2_net",
          //"SDL2_ttf",
          "main"
      };
  }
  라고 된 란이 있을건데 필요한 부분의 주석을 지워주자. 일단 SDL2_image의 주석은 지워주자.

16. 후.... 이제 올 것이 왔다. ndk-build 했던것과 마찬가지로 cmd로 폴더로 가서 ant debug 명령을 입력해준다.
    빌드가 제대로 됬다면 쉬발 게임 독립 만세다. bin 폴더에 apk가 당당히 생성 되어 있을것이다. 에러가 났다면... 구글링 하셈 ㅡ.ㅡ

    녹스 플레이어든 님 스마트폰이든 에뮬레이터든 뭐든 연결해서 테스트 해본다. 실행이 되는가?
    안될거임ㅋ 

   나 같은 경우엔 load error SDL_image from loader 인가 뭐시긴가 뜨더라.
   걱정 마셈 진짜 거의 다 왔으니까.

17. android-project/src/com/tutorial/game 까지 가는 폴더를 만들어주자. 그리고 .java 파일을 하나 만들어서 안에다
     package com.tutorial.game;

         import org.libsdl.app.SDLActivity;

         public class HelloSDL2Activity extends SDLActivity

         {

         }

      를 복붙한다.

18. AndroidMenifest.xml 안의

    package="org.libsdl.app" -> package="com.tutorial.game" 
    android:name="SDLActivity" -> android:name="HelloSDL2Activity"
    로 각각 수정해준다.

    앱 이름을 바꾸고 싶으면 res/values/strings.xml 안의 app_name을 바꿔주면 된다.

    빌드하고 실행 ㄱ. 이제 될 거임.

19.

[익명(222.120)]

어우야 고생했어..나도 이거 나중에 참고하게될지도 ㄱㅅ

[Akssus(akssus)]

글 수정이 안되는데 18단계에서 이미지 파일들은 android-project/assets 안에 넣으면 됨

[123123(121.150)]

SDL 보통 SDL이미지보다 OPENGL 쓰지 않냐?

[Akssus(akssus)]

ㄴ 어.. 나도 배우는 중이라 잘 모르긴 한데 3D 안 할거면 오픈지엘까지 쓸 필요 없지 않음? SDL로도 충분히 가속될건데

[익명(182.230)]

배보다 배꼽이 더 크네..., 간단한 겜 만들려고 sdl 쓰는건데 이럴꺼면 엔진 쓰는게 답인듯 ㅇㅇ