您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

Android 應用內版本更新實作:檢查、下載與自動安裝

編輯:iOS 開發綜合

歡迎 Follow 我的 GitHub,也欢迎关注我的 CSDN。

為了提升用戶體驗,App 內通常都會自帶更新功能。這裡寫了一個簡單的 Demo 說明實現思路,其中有幾個細節值得注意。網絡請求部分用了 Retrofit 配合 RxJava。

Github 下載地址見原文。

1. 整體邏輯

請求服務器判斷是否存在新版本;若有,則下載 Apk,下載完成後自動觸發安裝,高版本會覆蓋低版本。

public class MainActivity extends AppCompatActivity {
    private static final String APP_NAME = 'Ped_android';
    private static final String VERSION = '1.0.0';
    private static final String INFO_NAME = '計步器';
    private static final String STORE_APK = 'chunyu_apk';

    @Bind(R.id.main_b_install_apk) Button mBInstallApk;
    private UpdateAppUtils.UpdateCallback mUpdateCallback; // 更新回調

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ButterKnife.bind(this);

        mUpdateCallback = new UpdateAppUtils.UpdateCallback() {
            @Override
            public void onSuccess(UpdateInfo updateInfo) {
                Toast.makeText(MainActivity.this, '有更新', Toast.LENGTH_SHORT).show();
                UpdateAppUtils.downloadApk(MainActivity.this, updateInfo, INFO_NAME, STORE_APK);
            }

            @Override
            public void onError() {
                Toast.makeText(MainActivity.this, '無更新', Toast.LENGTH_SHORT).show();
            }
        };

        mBInstallApk.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                UpdateAppUtils.checkUpdate(APP_NAME, VERSION, mUpdateCallback);
            }
        });
    }
}

UpdateAppUtils 是核心類:傳入 App 代號與當前版本號,異步向服務器查詢。若存在新版本,則下載 Apk 並自動安裝。

2. 網絡請求

更新接口的參數是 App 代號和當前版本號。

/**
 * 更新服務
 */
public interface UpdateService {
    String ENDPOINT = 'https://www.chunyuyisheng.com';

    @GET('/cmsapi/app/update')
    Observable<UpdateInfo> getUpdateInfo(
            @Query('appName') String appName,
            @Query('version') String version);
}

創建服務的工廠類:

/**
 * 創建 Retrofit 服務
 */
public class ServiceFactory {
    public static <T> T createServiceFrom(final Class<T> serviceClass, String endpoint) {
        Retrofit adapter = new Retrofit.Builder()
                .baseUrl(endpoint)
                .addCallAdapterFactory(RxJavaCallAdapterFactory.create()) // 添加Rx適配器
                .addConverterFactory(GsonConverterFactory.create())       // 添加Gson轉換器
                .build();
        return adapter.create(serviceClass);
    }
}

更新信息的 JSON 對象:

/**
 * 更新信息(JSON)
 */
public class UpdateInfo {
    public Data data;            // 信息
    public Integer error_code;   // 錯誤代碼
    public String error_msg;     // 錯誤信息

    public static class Data {
        public String curVersion;   // 當前版本
        public String appURL;       // 下載地址
        public String description;  // 描述
        public String minVersion;   // 最低版本
        public String appName;      // 應用名稱
    }

    @Override
    public String toString() {
        return '當前版本: ' + data.curVersion
                + ', 下載地址: ' + data.appURL
                + ', 描述信息: ' + data.description
                + ', 最低版本: ' + data.minVersion
                + ', 應用代稱: ' + data.appName
                + ', 錯誤代碼: ' + error_code
                + ', 錯誤信息: ' + error_msg;
    }
}

3. 檢查更新與下載

UpdateAppUtils 提供兩個關鍵方法:checkUpdate 負責查詢,downloadApk 負責下載。

/**
 * 更新管理器
 */
@SuppressWarnings('unused')
public class UpdateAppUtils {
    private static final String TAG = 'DEBUG-WCL: ' + UpdateAppUtils.class.getSimpleName();

    /**
     * 檢查更新
     */
    public static void checkUpdate(String appCode, String curVersion, UpdateCallback updateCallback) {
        UpdateService updateService = ServiceFactory.createServiceFrom(UpdateService.class, UpdateService.ENDPOINT);
        updateService.getUpdateInfo(appCode, curVersion)
                .subscribeOn(Schedulers.newThread())
                .observeOn(AndroidSchedulers.mainThread())
                .subscribe(
                        updateInfo -> onNext(updateInfo, updateCallback),
                        throwable -> onError(throwable, updateCallback)
                );
    }

    // 處理返回數據
    private static void onNext(UpdateInfo updateInfo, UpdateCallback updateCallback) {
        Log.e(TAG, '返回數據: ' + updateInfo.toString());
        if (updateInfo.error_code != 0 || updateInfo.data == null || updateInfo.data.appURL == null) {
            updateCallback.onError(); // 失敗
        } else {
            updateCallback.onSuccess(updateInfo);
        }
    }

    // 錯誤信息
    private static void onError(Throwable throwable, UpdateCallback updateCallback) {
        updateCallback.onError();
    }

    /**
     * 下載 Apk
     * 默認位置: /storage/sdcard0/Download
     */
    public static void downloadApk(Context context, UpdateInfo updateInfo, String infoName, String storeApk) {
        if (!isDownloadManagerAvailable()) {
            return;
        }

        String description = updateInfo.data.description;
        String appUrl = updateInfo.data.appURL;
        if (appUrl == null || appUrl.isEmpty()) {
            Log.e(TAG, '請填寫App下載地址');
            return;
        }

        appUrl = appUrl.trim();                       // 去掉首尾空格
        if (!appUrl.startsWith('http')) {
            appUrl = 'https://' + appUrl;               // 添加Http信息
        }
        Log.e(TAG, 'appUrl: ' + appUrl);

        DownloadManager.Request request;
        try {
            request = new DownloadManager.Request(Uri.parse(appUrl));
        } catch (Exception e) {
            e.printStackTrace();
            return;
        }

        request.setTitle(infoName);
        request.setDescription(description);
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
            request.allowScanningByMediaScanner();
            request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
        }
        request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, storeApk);

        Context appContext = context.getApplicationContext();
        DownloadManager manager = (DownloadManager) appContext.getSystemService(Context.DOWNLOAD_SERVICE);

        // 存儲下載Key,供安裝時定位文件
        SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(appContext);
        sp.edit().putLong(PrefsConsts.DOWNLOAD_APK_ID_PREFS, manager.enqueue(request)).apply();
    }

    // 最小版本號大於9
    private static boolean isDownloadManagerAvailable() {
        return Build.VERSION.SDK_INT >= Build.VERSION_CODES.GINGERBREAD;
    }

    // 回調接口
    public interface UpdateCallback {
        void onSuccess(UpdateInfo updateInfo);
        void onError();
    }
}

檢查更新的要點:創建服務、在子線程發請求、在主線程接收結果,再判斷成功或失敗。

public static void checkUpdate(String appCode, String curVersion, UpdateCallback updateCallback) {
    UpdateService updateService = ServiceFactory.createServiceFrom(UpdateService.class, UpdateService.ENDPOINT);
    updateService.getUpdateInfo(appCode, curVersion)
            .subscribeOn(Schedulers.newThread())
            .observeOn(AndroidSchedulers.mainThread())
            .subscribe(
                    updateInfo -> onNext(updateInfo, updateCallback),
                    throwable -> onError(throwable, updateCallback)
            );
}

下載 Apk 的要點:解析並規範化 URL、設置通知信息與存儲位置、記住下載 ID。

使用 DownloadManager 下載文件是 Android 官方推薦的做法。
保存 manager.enqueue(request) 返回的下載 ID,是為了後續安裝時能準確找到這個 Apk。
默認存儲路徑為 /storage/sdcard0/Download。

4. 自動安裝

註冊廣播接收器監聽 ACTION_DOWNLOAD_COMPLETE。下載結束時系統會發出該廣播,取出文件 Uri 並與之前保存的 ID 比對,匹配成功後發起安裝 Intent。

/**
 * 安裝下載接收器
 */
public class InstallReceiver extends BroadcastReceiver {
    private static final String TAG = 'DEBUG-WCL: ' + InstallReceiver.class.getSimpleName();

    @Override
    public void onReceive(Context context, Intent intent) {
        if (intent.getAction().equals(DownloadManager.ACTION_DOWNLOAD_COMPLETE)) {
            long downloadApkId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);
            installApk(context, downloadApkId);
        }
    }

    // 安裝Apk
    private void installApk(Context context, long downloadApkId) {
        // 獲取存儲ID
        SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(context);
        long id = sp.getLong(PrefsConsts.DOWNLOAD_APK_ID_PREFS, -1L);

        if (downloadApkId == id) {
            DownloadManager dManager = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE);
            Intent install = new Intent(Intent.ACTION_VIEW);
            Uri downloadFileUri = dManager.getUriForDownloadedFile(downloadApkId);

            if (downloadFileUri != null) {
                install.setDataAndType(downloadFileUri, 'application/vnd.android.package-archive');
                install.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                context.startActivity(install);
            } else {
                Log.e(TAG, '下載失敗');
            }
        }
    }
}

只安裝本應用下載的 Apk,因此需要把下載 ID 與廣播帶回的 ID 做比對。
注意:下載失敗時同樣會收到 ACTION_DOWNLOAD_COMPLETE 廣播,此時 Uri 可能為空,必須判空處理,否則會崩潰。

以上就是完整流程。Enjoy it!

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved