App Center 배포 – Android 앱 내 업데이트

App Center 배포를 사용하면 App Center를 통해 배포할 때 사용자가 새 버전의 앱을 설치할 수 있습니다. 새 버전의 앱을 사용할 수 있는 경우 SDK는 사용자에게 업데이트 대화 상자를 표시하여 새 버전을 다운로드하거나 연기합니다. 업데이트하도록 선택하면 SDK가 애플리케이션을 업데이트하기 시작합니다.

앱에 앱 내 업데이트 추가

아직 애플리케이션에서 SDK를 설정하고 시작하지 않은 경우 시작 섹션을 따릅니다.

1. App Center 배포 모듈 추가

App Center SDK는 모듈식 접근 방식으로 설계되었으며 개발자는 관심 있는 서비스의 모듈만 통합하면 됩니다.

1. 프로젝트의 앱 수준 build.gradle 파일(app/build.gradle)을 열고 다음 줄을 apply plugin추가합니다.

   dependencies {
      def appCenterSdkVersion = '5.0.6'
      implementation "com.microsoft.appcenter:appcenter-distribute:${appCenterSdkVersion}"
   }
   

   비고

   Android Gradle 플러그 인 버전이 3.0.0보다 낮은 경우 구현 을 컴파일로 바꿔야 합니다.

2. build.gradle 파일을 저장하고 Android Studio에서 Gradle 동기화를 트리거해야 합니다.

3. DownloadManager 는 업데이트를 다운로드하는 데 사용됩니다. App Center SDK는 보안을 개선하기 위해 TLS 1.2를 적용합니다.

2. App Center 배포 시작

App Center를 사용하려면 사용하려는 모듈을 옵트인합니다. 기본적으로 모듈은 시작되지 않으며 SDK를 시작할 때 각 모듈을 명시적으로 호출해야 합니다.

메서드에 배포 클래스를 추가하여 App Center 배포 서비스를 시작합니다 AppCenter.start() .

AppCenter.start(getApplication(), "{Your App Secret}", Distribute.class);

AppCenter.start(application, "{Your App Secret}", Distribute::class.java)

위의 코드 샘플에서 {Your App Secret}를 귀하의 App Secret으로 대체했는지 확인하세요. 메서드에 클래스 start() 에 대한 참조 Distribute 를 추가하면 Android Studio에서 필요한 import 문을 자동으로 제안하지만 클래스 이름이 인식되지 않는다는 오류가 표시되면 작업 클래스의 import 문에 다음 줄을 추가합니다.

import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.distribute.Distribute;

import com.microsoft.appcenter.AppCenter
import com.microsoft.appcenter.distribute.Distribute

Google Play 빌드 준비

Google Play는 앱 내 업데이트 코드가 런타임에 사용되지 않더라도 악의적인 동작으로 간주합니다. 이 섹션에 설명된 대로 배포 SDK의 변형을 사용하거나 앱 내 업데이트 코드가 포함된 배포 SDK를 완전히 제거한 후 Google Play에 앱을 제출합니다. 이렇게 하지 않으면 Google Play에서 앱이 비준수 및 제거됩니다. 쉽게 만들기 위해, 스텁된 API가 포함된 App Center Distribute SDK의 버전을 제공하므로, 사용자가 해야 할 유일한 작업은 종속성을 교체하는 것입니다.

1. 프로젝트의 앱 수준 build.gradle 파일(app/build.gradle)을 엽니다.

2. 제품 버전을 추가하여 빌드 변형을 구성합니다.

   android {
       flavorDimensions "distribute"
       productFlavors {
           appCenter {
               dimension "distribute"
           }
           googlePlay {
               dimension "distribute"
           }
       }
   }
   

3. 제품 버전에 따라 다른 종속성을 사용하도록 종속성 블록을 수정합니다.

   dependencies {
       def appCenterSdkVersion = "5.0.6"
       appCenterImplementation "com.microsoft.appcenter:appcenter-distribute:${appCenterSdkVersion}"
       googlePlayImplementation "com.microsoft.appcenter:appcenter-distribute-play:${appCenterSdkVersion}"
   }
   

4. build.gradle 파일을 저장하고 Android Studio에서 Gradle 동기화를 트리거해야 합니다.

5. 빌드 > 선택 빌드 변형 드롭다운 메뉴 또는 도구 창 표시줄의 빌드 변형에서 빌드 변형을 변경할 수 있습니다.

Android 설명서에서 빌드 변형을 구성하는 방법에 대해 자세히 읽을 수 있습니다.

프라이빗 메일 그룹 사용

기본적으로 배포는 공용 배포 그룹을 사용합니다. 프라이빗 메일 그룹을 사용하려면 API를 통해 setUpdateTrack 명시적으로 설정해야 합니다.

Distribute.setUpdateTrack(UpdateTrack.PRIVATE);

Distribute.setUpdateTrack(UpdateTrack.PRIVATE)

앱이 활성 상태(즉, Distribute.setUpdateTrack(UpdateTrack.PRIVATE); 및 AppCenter.start 이후)일 때 사용자를 인증하기 위한 브라우저 창이 열립니다. 모든 후속 업데이트 검사는 프라이빗 트랙에서 최신 릴리스를 가져옵니다.

사용자가 프라이빗 트랙에 있는 경우 인증에 성공하면 멤버인 프라이빗 메일 그룹에서 최신 릴리스를 받게 됩니다. 사용자가 공개 트랙에 있는 경우 퍼블릭 배포 그룹에서 최신 릴리스를 받게 된다는 의미입니다.

업데이트에 대한 자동 확인 사용 안 함

기본적으로 SDK는 새 릴리스를 자동으로 확인합니다.

• 애플리케이션이 시작될 때.
• 백그라운드로 전환한 후 애플리케이션이 포그라운드로 전환되는 경우
• 이전에 사용하지 않도록 설정한 경우 배포 모듈을 사용하도록 설정하는 경우

새 릴리스를 수동으로 확인하려면 업데이트에 대한 자동 검사를 사용하지 않도록 설정할 수 있습니다. 이렇게 하려면 SDK가 시작되기 전에 다음 메서드를 호출합니다.

Distribute.disableAutomaticCheckForUpdate();

Distribute.disableAutomaticCheckForUpdate()

그런 다음, 다음 섹션에 checkForUpdate 설명된 API를 사용할 수 있습니다.

수동으로 업데이트 확인

Distribute.checkForUpdate();

Distribute.checkForUpdate()

그러면 사용 가능한 새 릴리스가 있는 경우 App Center에 요청을 보내고 업데이트 대화 상자를 표시합니다.

앱 내 업데이트 대화 상자 사용자 지정 또는 지역화

1. 텍스트 사용자 지정 또는 지역화

업데이트 대화 상자에 표시된 텍스트를 변경하거나 지역화하려는 경우 사용자 고유의 리소스 문자열을 쉽게 제공할 수 있습니다. 이 리소스 파일의 문자열 파일을 확인합니다. 동일한 문자열 이름/키를 사용하고 사용자 고유의 앱 리소스 파일의 대화 상자에 반영할 지역화된 값을 지정합니다.

2. 업데이트 대화 상자 사용자 지정

인터페이스를 구현하여 기본 업데이트 대화 상자의 모양을 사용자 지정할 수 있습니다 DistributeListener . 다음 예제와 같이 호출 AppCenter.start 하기 전에 수신기를 등록해야 합니다.

Distribute.setListener(new MyDistributeListener());
AppCenter.start(...);

Distribute.setListener(MyDistributeListener())
AppCenter.start(...)

다음은 SDK 대화 상자를 사용자 지정 대화 상자로 바꾸는 수신기 구현의 예입니다.

import android.app.Activity;
import android.app.AlertDialog;
import android.content.DialogInterface;
import android.net.Uri;

import com.microsoft.appcenter.distribute.Distribute;
import com.microsoft.appcenter.distribute.DistributeListener;
import com.microsoft.appcenter.distribute.ReleaseDetails;
import com.microsoft.appcenter.distribute.UpdateAction;

public class MyDistributeListener implements DistributeListener {

    @Override
    public boolean onReleaseAvailable(Activity activity, ReleaseDetails releaseDetails) {

        // Look at releaseDetails public methods to get version information, release notes text or release notes URL
        String versionName = releaseDetails.getShortVersion();
        int versionCode = releaseDetails.getVersion();
        String releaseNotes = releaseDetails.getReleaseNotes();
        Uri releaseNotesUrl = releaseDetails.getReleaseNotesUrl();

        // Build our own dialog title and message
        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(activity);
        dialogBuilder.setTitle("Version " + versionName + " available!"); // you should use a string resource instead, this is just a simple example
        dialogBuilder.setMessage(releaseNotes);

        // Mimic default SDK buttons
        dialogBuilder.setPositiveButton(com.microsoft.appcenter.distribute.R.string.appcenter_distribute_update_dialog_download, new DialogInterface.OnClickListener() {

            @Override
            public void onClick(DialogInterface dialog, int which) {

                // This method is used to tell the SDK what button was clicked
                Distribute.notifyUpdateAction(UpdateAction.UPDATE);
            }
        });

        // We can postpone the release only if the update isn't mandatory
        if (!releaseDetails.isMandatoryUpdate()) {
            dialogBuilder.setNegativeButton(com.microsoft.appcenter.distribute.R.string.appcenter_distribute_update_dialog_postpone, new DialogInterface.OnClickListener() {

                @Override
                public void onClick(DialogInterface dialog, int which) {

                    // This method is used to tell the SDK what button was clicked
                    Distribute.notifyUpdateAction(UpdateAction.POSTPONE);
                }
            });
        }
        dialogBuilder.setCancelable(false); // if it's cancelable you should map cancel to postpone, but only for optional updates
        dialogBuilder.create().show();

        // Return true if you're using your own dialog, false otherwise
        return true;
    }
    
    @Override
    public void onNoReleaseAvailable(Activity activity) {
        Toast.makeText(activity, activity.getString(R.string.no_updates_available), Toast.LENGTH_LONG).show();
    }
}

import android.app.Activity
import android.app.AlertDialog
import com.microsoft.appcenter.distribute.Distribute
import com.microsoft.appcenter.distribute.DistributeListener
import com.microsoft.appcenter.distribute.ReleaseDetails
import com.microsoft.appcenter.distribute.UpdateAction

class MyDistributeListener : DistributeListener {

    override fun onReleaseAvailable(activity: Activity, releaseDetails: ReleaseDetails): Boolean {

        // Look at releaseDetails public methods to get version information, release notes text or release notes URL
        val versionName = releaseDetails.shortVersion
        val versionCode = releaseDetails.version
        val releaseNotes = releaseDetails.releaseNotes
        val releaseNotesUrl = releaseDetails.releaseNotesUrl

        // Build our own dialog title and message
        val dialogBuilder = AlertDialog.Builder(activity)
        dialogBuilder.setTitle("Version $versionName available!") // you should use a string resource instead, this is just a simple example
        dialogBuilder.setMessage(releaseNotes)

        // Mimic default SDK buttons
        dialogBuilder.setPositiveButton(
            com.microsoft.appcenter.distribute.R.string.appcenter_distribute_update_dialog_download
        ) { dialog, which ->
            // This method is used to tell the SDK what button was clicked
            Distribute.notifyUpdateAction(UpdateAction.UPDATE)
        }

        // We can postpone the release only if the update isn't mandatory
        if (!releaseDetails.isMandatoryUpdate) {
            dialogBuilder.setNegativeButton(
                com.microsoft.appcenter.distribute.R.string.appcenter_distribute_update_dialog_postpone
            ) { dialog, which ->
                // This method is used to tell the SDK what button was clicked
                Distribute.notifyUpdateAction(UpdateAction.POSTPONE)
            }
        }
        dialogBuilder.setCancelable(false) // if it's cancelable you should map cancel to postpone, but only for optional updates
        dialogBuilder.create().show()

        // Return true if you're using your own dialog, false otherwise
        return true
    }

    override fun onNoReleaseAvailable(activity: Activity) {
        Toast.makeText(activity, activity.getString(R.string.no_updates_available), Toast.LENGTH_LONG).show()
    }
}

예제에 표시된 것처럼, 수신기가 true를 반환하는 경우 Distribute.notifyUpdateAction(UpdateAction.UPDATE); 또는 Distribute.notifyUpdateAction(UpdateAction.POSTPONE);을 호출해야 합니다.

호출 notifyUpdateAction하지 않으면 모든 활동 변경에 대해 콜백이 반복됩니다.

사용자 동작이 SDK에 알림이 표시되기 전에 활동이 변경되면 동일한 릴리스로 수신기를 다시 호출할 수 있습니다.

이 동작은 다음 시나리오를 다루는 데 필요합니다.

• 애플리케이션이 백그라운드로 전송된 후(예: HOME 누르기) 다른 작업에서 다시 시작됩니다.
• 애플리케이션을 종료하지 않고도(예: 일부 알림 클릭) 활동이 다른 작업에서 처리됩니다.
• 다른 유사한 시나리오.

이 경우 대화 상자를 호스팅하는 활동이 사용자 상호 작용 없이 대체될 수 있습니다. 따라서 SDK는 사용자 지정 대화 상자를 복원할 수 있도록 수신기를 다시 호출합니다.

SDK가 업데이트를 확인할 때 현재 사용 중인 onNoReleaseAvailable보다 최신 업데이트가 없으면 인터페이스 콜백에서 DistributeListener이 호출됩니다. 이렇게 하면 이러한 시나리오에서 사용자 지정 코드를 실행할 수 있습니다. 위의 예제에서는 업데이트를 찾을 수 없을 때 알림 메시지를 표시하는 방법을 보여 줍니다.

런타임에 App Center 배포를 활성화하거나 비활성화하기

런타임에 App Center 배포를 사용하거나 사용하지 않도록 설정할 수 있습니다. 사용하지 않도록 설정하면 SDK에서 앱 내 업데이트 기능을 제공하지 않지만 App Center 포털에서 배포 서비스를 계속 사용할 수 있습니다.

Distribute.setEnabled(false);

Distribute.setEnabled(false)

App Center 배포를 다시 사용하도록 설정하려면 동일한 API를 사용하고, 매개 변수로 true를 전달하십시오.

Distribute.setEnabled(true);

Distribute.setEnabled(true)

상태는 애플리케이션 시작 시 디바이스의 스토리지에 유지됩니다.

이 API는 비동기이며 App Center 비동기 API 가이드에서 이에 대해 자세히 확인할 수 있습니다.

App Center 배포 서비스가 활성화되어 있는지 확인

App Center 배포가 사용하도록 설정되어 있는지 여부도 확인할 수 있습니다.

Distribute.isEnabled();

Distribute.isEnabled()

이 API는 비동기이며 App Center 비동기 API 가이드에서 이에 대해 자세히 확인할 수 있습니다.

디버그 빌드에 앱 내 업데이트 사용

기본적으로 App Center는 릴리스 빌드에 대해서만 앱 내 업데이트를 사용하도록 설정합니다.

디버그 빌드에서 앱 내 업데이트를 사용하도록 설정하려면 다음 메서드를 호출합니다 AppCenter.start.

Distribute.setEnabledForDebuggableBuild(true);

Distribute.setEnabledForDebuggableBuild(true)

앱 내 업데이트는 어떻게 작동합니까?

앱 내 업데이트 기능은 다음과 같이 작동합니다.

1. 이 기능은 App Center 배포 서비스를 사용하여 배포되는 릴리스 빌드(기본적으로)에서만 작동합니다.

2. SDK를 통합하고 앱의 릴리스 버전을 빌드하고 App Center에 업로드하면 해당 메일 그룹의 사용자에게 이메일을 통해 새 릴리스에 대한 알림이 표시됩니다.

3. 각 사용자가 전자 메일에서 링크를 열면 애플리케이션이 디바이스에 설치됩니다. 이메일 링크를 사용하여 설치하는 것이 중요합니다. 우리는 사이드 로딩을 지원하지 않습니다. 애플리케이션이 링크에서 다운로드되면 SDK는 쿠키에서 중요한 정보를 저장하여 나중에 업데이트를 확인합니다. 그렇지 않으면 SDK에 해당 키 정보가 없습니다.

4. 애플리케이션이 트랙을 프라이빗으로 설정하면 브라우저가 열리고 사용자를 인증하고 앱에서 바로 업데이트를 사용하도록 설정합니다. 공용 트랙으로 다시 전환하고 나중에 다시 비공개로 전환할 때도 인증 정보가 유효한 상태로 유지되는 한 브라우저가 다시 열리지 않습니다. 브라우저 인증에 성공하면 사용자가 자동으로 애플리케이션으로 다시 리디렉션됩니다. 트랙이 공용(기본값)이면 다음 단계가 직접 수행됩니다.

5. 앱의 새 릴리스는 다음과 같은 경우 사용자에게 애플리케이션을 업데이트하도록 요청하는 앱 내 업데이트 대화 상자를 보여 줍니다.

   • versionCode의 더 높은 값 또는
   • 의 값이 versionCode 같지만 다른 값입니다 versionName.

앱 내 업데이트를 테스트하려면 어떻게 해야 하나요?

앱 내 업데이트를 테스트하려면 App Center SDK의 배포 모듈을 사용하는 릴리스 빌드를 App Center Portal에 업로드하여 매번 버전 번호를 늘려야 합니다.

1. 아직 앱이 없는 경우 App Center 포털에서 앱을 만듭니다.
2. 새 메일 그룹을 만들고 이름을 지정하여 앱 내 업데이트 기능을 테스트하기 위한 것임을 인식할 수 있습니다.
3. 자신(또는 앱 내 업데이트 기능 테스트에 포함하려는 모든 사용자)을 추가합니다. App Center에서 해당 앱에 사용되지 않은 새 전자 메일 주소 또는 삭제된 전자 메일 주소를 사용합니다. 이렇게 하면 실제 테스터의 환경에 가까운 환경이 보장됩니다.
4. 위에서 설명된 대로 App Center 배포를 포함하고 설치 논리를 갖춘 앱의 새 빌드를 만드십시오. 그룹이 프라이빗인 경우 setUpdateTrack API 사용을 시작하기 전에 프라이빗 앱 내 업데이트 트랙을 설정하는 것을 잊지 마세요.
5. 포털에서 새 릴리스 배포 단추를 클릭하고 앱 빌드를 업로드합니다.
6. 업로드가 완료되면 다음을 클릭하고 해당 앱 배포의 대상으로 만든 배포 그룹을 선택합니다.
7. 배포를 검토하고 빌드를 앱 내 테스트 그룹에 배포합니다.
8. 해당 그룹의 사용자는 앱의 테스터로 초대를 받게 됩니다. 초대를 수락하면 모바일 디바이스에서 App Center 포털에서 앱을 다운로드할 수 있습니다. 앱 내 업데이트가 설치되면 앱 내 업데이트를 테스트할 준비가 된 것입니다.
9. 앱의 versionCode을(를) 업데이트하세요.
10. 앱의 릴리스 버전을 빌드하고 이전 단계에서 수행한 것처럼 앱의 새 빌드를 업로드하고 이전에 만든 배포 그룹에 배포합니다. 다음에 앱이 시작될 때 배포 그룹의 구성원에게 새 버전에 대한 알림이 표시됩니다.