런타임 지원 SDK 빌드 및 사용

1
Key concepts
2
Set up your development environment
3
Build an RE SDK
4
Consume the RE SDK
5
Testing, and building for distribution

테스트 앱 빌드 및 구성

이 섹션에서는 런타임 지원 앱을 사용하도록 앱을 설정하고 준비하는 방법을 설명합니다. 로컬 테스트용 SDK입니다.

앱 준비

먼저 별도의 독립형 프로젝트 또는 모듈을 만듭니다.

이 시나리오에서는 앱에 SDK 코드가 포함되어 있지 않습니다. kube-APIserver로 Maven 종속 항목을 대신 사용하세요.

런타임 지원 SDK를 사용하는 앱을 빌드하려면 Android 스튜디오가 필요함 Ladybug Canary 1 이상 및 Android Gradle 플러그인 (AGP) 8.7.0-alpha01 이상

  1. 앞서 설명한 것과 동일한 단계를 따라 개발 환경테스트용 기기/에뮬레이터를 참고하세요.
  2. 다음에 설명된 플래그를 사용하여 SDK 런타임 사용 설정 3단계: SDK 섹션 준비.

    # This enables the Privacy Sandbox for your project on Android Studio.
    android.experimental.privacysandboxsdk.enable=true
    android.experimental.privacysandboxsdk.requireServices=false
    
  3. 프로젝트의 최상위 build.gradle에 개인 정보 보호 샌드박스 Maven URL을 추가합니다. 파일에서 참조됩니다.

        allprojects {
            repositories {
                google()
                maven {
                    url "https://maven.privacysandbox.com/v1/repository"
                    }
                }
            }
    
  4. 기존 광고 라이브러리 (런타임 인식 SDK) Maven 타겟의 Maven 종속 항목을 유지합니다.

  5. SDK 라이브러리에 대한 종속 항목이 있는 build.gradle 프로젝트에 privacySandbox 블록을 추가하고 true를 사용 설정합니다.

    plugins {
        id 'com.android.application'
        id 'org.jetbrains.kotlin.android'
    }
    
    android {
        //...
        privacySandbox {
            enable true
        }
        //...
    }
    
    dependencies {
        // SDK library dependency
        implementation(<maven coordinates to SDK library>)
    }
    
  6. 이제 앱은 SDK의 API를 API 사용 섹션에 설명되어 있습니다

앱 빌드

평소처럼 앱을 AAB (Android App Bundle)로 빌드할 수 있습니다.

로컬에서 SDK 테스트

테스트 앱을 실행하려면 테스트에 런타임 지원 SDK와 앱을 설치하세요. 에뮬레이터에 액세스할 수 있습니다.

  1. 테스트 앱의 Android 스튜디오 프로젝트를 엽니다.
  2. Run > Edit Configurations로 이동합니다. 'Run/Debug' 구성 기간 표시됩니다. '기본 APK'로 배포할 수 있습니다. 또는 'APK의 번들'을 선택합니다.
  3. Launch Options에서 LaunchSpecated Activity로 설정합니다.
  4. 활동 옆에 있는 점 3개로 된 메뉴를 클릭하고 기본 탭을 선택합니다. 고객의 활동
  5. Apply를 클릭한 후 OK를 클릭합니다.
  6. Run을 클릭하여 테스트 기기에 클라이언트 앱과 SDK를 설치합니다.
를 통해 개인정보처리방침을 정의할 수 있습니다. <ph type="x-smartling-placeholder">

배포를 위한 SDK 빌드

SDK를 Android SDK 번들 (ASB) 앱 스토어에 게시할 수 있습니다. ASB는 서명되지 않은 간행물입니다. Android App Bundle과 동등한 패키지입니다.

ASB 또는 ASB에서 파생된 Android SDK 보관 파일 (ASAR)을 함께 사용합니다. 앱의 AAB는 Bundletool에 의해 설치 가능한 APK 집합으로 변환됩니다. 앱 개발자는 Android 스튜디오 (현재는 카나리아 배포)에서 버전)을 사용하여 모든 APK 변형을 출력합니다.

Bundletool AAB와 ASB를 사용하고, APK 변형 세트를 출력할 수 있습니다.

  1. SDK 런타임의 하위 호환 모드에서 실행되도록 빌드된 APK SDK 런타임과 호환되지 않는 기기 (Android 13 이하) 이 APK에는 앱과 SDK에 필요한 모든 코드가 포함되어 있습니다.
  2. SDK 런타임 (Android 14 이상). 이 APK에는 런타임 지원 SDK의 API 스텁과 함께 앱 코드를 실행합니다.
  3. 런타임 지원 SDK 코드가 포함된 SDK APK(다음 이전에 설치될 예정) 앱 APK를 초기화해야 합니다.

ASB는 두 가지 방법으로 빌드할 수 있습니다.

  • Android 스튜디오 <ph type="x-smartling-placeholder">
      </ph>
    1. 프로젝트를 빌드합니다. 이렇게 하려면 Build > 프로젝트를 다시 빌드합니다.
    2. ASB 파일은 런타임 지원 ASB 모듈의 다음 위치에 있습니다. build/outputs/asb/single/<your-asb-module-name>.asb
  • Bundletool의 명령줄 - 다음 이 안내를 따르세요.

업로드 키로 SDK에 서명해야 게시할 수 있습니다. 사용 업로드 키를 사용하여 SDK Console에 업로드하기 위해 ASB에 서명합니다. Google은 인증서를 업로드하여 신원을 확인합니다

다음 단계는 ASB에 서명하기 위해 취해야 할 조치에 관한 개요입니다.

  1. 키 저장소 생성 및 업로드 키 생성 이것은 앱의 키 저장소 및 업로드 키 생성을 참조하세요.
  2. 업로드 키로 ASB에 서명합니다. 이를 위해 signatureConfig 블록을 추가합니다. build.gradle 파일에 새로 생성된 키와 키 저장소를 지정합니다.
android {
  signingConfig {
    storeFile file(path-to-keystore.jks)
    storePassword "keystorePassword"
    keyAlias "UploadKey"
    keyPassword "keyPassword"
  }
}

앱 스토어에서는 이러한 구성요소를 사용하여 런타임 지원 앱 배포 SDK 런타임이 앱과 지속적으로 작동합니다. 저장소를 사용하여 런타임 지원 SDK에 대한 지원을 확장합니다.

4단계: 런타임 지원 SDK 사용