1. 요구사항
Android AppSealing은 다음과 같이 빌드된 앱을 지원합니다.
- Unity 엔진 : 4.6 이상
- Unreal 엔진: 버전 4.1 이상
- Flutter: 버전 2 ~ 3.x
- 리액트 네이티브: 0.60 ~ 0.76.3 ( 0.70 이상 권장 )
- Android SDK: API 8 ~ 최신 / Android SDK build-tools revision 19.1 이상
2. 실링
2.1 APK 또는 앱번들 업로드
Android AppSealing을 적용하기 위해서는 APK 파일 또는 앱번들 파일을 AppSealing 서버로 업로드하여 실링 과정을 마무리하셔야 합니다.
① AppSealing 개발자 콘솔에 접속하여 실링 페이지로 이동. (Fig.1)
(Fig.1)
② 옵션 선택 후 파일 업로드.
- 실링 모드
- 테스트 모드: 배포용 모드로 실링 하기 전에 테스트해보기 위한 실링 모드.
- 배포용 모드: 마켓에 배포하기 위한 실링 모드.
- DEX 암호화
- 멀티 DEX 파일들을 암화 함으로서 자바 코드를 보호합니다.
- 루팅
- 이 옵션은 루팅 된 디바이스에서 앱 실행을 허용 또는 차단합니다.
- 에뮬레이터
- 블루스택스 및 녹스 에뮬레이터 실행을 허용 또는 차단합니다. (다른 에뮬레이터에 대해 상시지원을 보장하지 않습니다.)
- 매크로
- 2.16.0.0 이상부터 선택할 수 있습니다. 매크로가 설치되어 있을 때 앱 실행 차단 여부를 결정합니다.
- 패킷공격
- 2.16.0.0 이상부터 선택할 수 있습니다. 패킷 공격 도구가 설치되어 있을 때 앱 실행 차단 여부를 결정합니다.
③ '실링 하기' 클릭.
2.2 실링된 앱 다운로드
실링 시작 후 파일 크기에 따라 AppSealing 서버에서 실링 하는 시간이 다릅니다. 실링이 완료되면 별도로 이메일을 통해 결과를 받아 보실 수 있습니다.
① 실링이 완료되면 파일을 다운로드하기 위해 실링 페이지 하단에 있는 ‘실링 내역’으로 이동. (Fig.2)
(Fig.2)
② 실링 내역에는 실링 한 앱의 결과와 성공 시 다운로드 버튼이 활성화돼 있습니다.
③ 실링된 앱을 다운로드한 후 디바이스에 해당 앱을 설치해 보실 수 있습니다.
NOTE:
실링 과정에서 APK의 키 스토어 서명이 풀립니다. 정상적인 APK 파일의 설치 및 배포를 위해서는 다운로드 후 키 스토어 서명을 진행해 주시기를 바랍니다.
구글 플레이 등록을 위해 Zipalign 또한 진행해 주시기를 바랍니다.
3. Zipalign 및 키 스토어 재서명
실링 된 APK 파일은 서명이 해제되어 스마트폰에 바로 설치할 수 없습니다.
앱실링연동에 불편을 최소화 할 수 있도록 웹 콘솔에 키스토어를 업로드하여 앱실링 적용 후 자동으로 서명된 APK 또는 AAB를 다운로드할 수 있는 기능을 제공하고 있습니다.
실링이 완료된 앱을 다운로드할 때 아래와 같은 팝업창이 표시되며, 사용중인 키스토어를 업로드하여 서명 및 후 다운로드할 수 있습니다.
<웹 콘솔에서 실링 완료된 앱을 다운로드할 때 표시되는 팝업창>
앱실링 콘솔에 키스토어 정보를 업로드하고 싶지 않은 경우에는 APK파일을 서명하는 작업을 별도로 진행해야 합니다. 앱 서명을 직접 처리하는 경우 아래 내용을 참고하시기 바랍니다.
3.1 Zipalign 적용 하기
zipalign -p -f -v 4 [APK_FILE] [ZIPALIGNED_OUTPUT_APK_FILE]
3.2 키 스토어 재서명
apksigner sign --ks [KEY_STORE_FILE] --ks-key-alias [ALIAS] [APK_FILE]
주의! AppSealing에서는 v1 서명이 필수적으로 요구됩니다. v2 서명만 적용된 apk는 정상실행되지 않습니다.
3.3 참조
- Zipalign과 apksigner툴은 %ANDROID_SDK_HOME%\build-tools\%ANY_SDK_VERSION% 경로에 있습니다.
- Zipalign 및 apksigner에 대해서는 아래 구글 가이드를 참고하시기 바랍니다.