[QuickSDK] Unity Quick SDK연동하기

이번에 유니티로 만든 게임을 중국에 출시하면서 그를 위한 작업을 하며 있었던 일을 작성합니다.

 

Unity 기반 게임을 중국에 출시하려면 국내 및 글로벌 출시와는 전혀 다른 환경에 대응해야 합니다. 특히 서구권에서 사용하는 대부분의 플러그인과 서비스들은 중국 내에서 차단되거나 작동하지 않습니다.

이번 글에서는 중국 서비스를 위한 필수 작업인 Firebase, Google Play Games, AdMob, AppLovin 등의 서구권 플러그인 제거, 그리고 중국 전용 통합 SDK인 QuickSDK 연동 과정을 정리해보겠습니다.

---

 1. 서구권 플러그인 제거

중국에서는 다음과 같은 서비스들을 사용할 수 없습니다:

• Firebase (Crashlytics, Analytics 포함)
• Google Play Games Services (GPGS)
• AdMob
• AppLovin, ironSource, Unity Ads 등 대부분의 서구 광고 네트워크

따라서 다음과 같은 조치가 필요합니다:

 제거 대상 정리

• Firebase 관련 라이브러리 제거
  • FirebaseAnalytics, FirebaseCrashlytics, GoogleServices.json 등
• GPGS Plugin 제거
• AdMob / AppLovin SDK 제거
• Google Sign-In 관련 코드 제거

 유의할 점

• Unity 프로젝트의 Plugins/Android, Assets/Plugins, Assets/GoogleMobileAds 등에서 관련 파일을 직접 제거
• gradleTemplate, AndroidManifest, proguard-user.txt 등의 커스텀 설정에서도 관련 내용 제거 필요
• 코드에서 null check 또는 플랫폼 분기 처리 필수

#if !UNITY_CHINA
    FirebaseAnalytics.LogEvent("game_start");
#endif

 

 

 

일단 우선적으로 구글 및 서구권 플러그인 제거가 되었다면 이제 quickSDK를 연동해야합니다.

https://www.quicksdk.com/doc-20.html

 

도큐먼트는 위에서 확인할 수 있으며 유니티 패키지를 다운로드 받은 후 임포트하면됩니다.

아마 빌드에러가 발생할 것 인데, 유니티 패키지가 최신화되어있지 않습니다.

 

플러그인 폴더에 .aar을 제외하고 사용하지 않는 형식의 플러그인 잔여 파일들은 제거하거나, 임포트하지 않도록 해야합니다.

그래야 충돌없이 빌드가 가능합니다.

 

그 외에 중국 연령정책 등을 준수하기 위한 과정을 진행합니다.

 

 

후기)

중국이 폐쇄적이지만 기술의 발전은 대단하네요.

언어의 장벽때문에 연동이 힘들었지만, 플러그인이나 페이지의 완성도는 생각했던 것 이상이었습니다.