APK 在線升級幾乎是全部程序必備的功能。javascript
在線升級功能能解決已有的問題並提供更豐富的新功能。java
基本的流程是:android
- 檢測到新版本信息
- 彈出升級提示窗口
- 點擊 No 不進行升級,完畢!
- 點擊 Yes 後臺下載升級程序
- 程序下載完成進入安裝頁面
- 安裝成功,進入新程序
下面將介紹使用 UpdateAppUtil 實如今線升級功能json
須要受權 android.permission.INTERNET,android.permission.WRITE_EXTERNAL_STORAGE 權限,具體申請版本在這裏不展開了。api
有興趣的小夥伴能夠看以往的文章。服務器
通常是訪問服務器,獲取新版本信息(如下面爲例)app
{
"url":"https://www.google.com/test/a670ef11/apk/test.apk", "versionCode":1, "versionName":"v2.1.0", "create_time":"2019-12-14 03:44:34", "description":"新增衛星鏈路,支持全球訪問。" }
必需要有 APK 的下載連接(url),版本號(versionCode)或者版本名(versionName)。框架
都是接下來須要用到的。ide
UpdateAppUtil.from(MainActivity.this) .checkBy(UpdateAppUtil.CHECK_BY_VERSION_NAME) //更新檢測方式,默認爲VersionCode .serverVersionCode(0) .serverVersionName(version) .updateInfo(description) .apkPath(url) .update();
字段 | 說明 |
---|---|
checkBy | 是否須要彈出升級提示的依據。CHECK_BY_VERSION_NAME 是根據 serverVersionName 的不一樣就彈出升級提示。CHECK_BY_VERSION_CODE 是根據 serverVersionCode 高於當前軟件版本彈出升級提示。 |
serverVersionCode | 設置新軟件的 versionCode (如示例的 1 ) |
serverVersionName | 設置新軟件的 versionName (如示例的 "v2.1.0" ) |
updateInfo | 升級提示窗口顯示的新軟件描述 |
apkPath | 新軟件下載連接(須要經過此連接下載新軟件) |
update | 立刻進行升級檢查(如知足升級要求,彈出升級提示) |
isForce | 若是不選擇升級,直接退出程序 |
Android 有多種框架能夠下載程序(okhttp等),也能夠開啓一個線程去下載(IntentService)。ui
而 UpdateAppUtil 採用 Android SDK 提供的下載框架 DownloadManager,
public static void downloadWithAutoInstall(Context context, String url, String fileName, String notificationTitle, String descriptInfo) { if (TextUtils.isEmpty(url)) { Log.e(TAG, "url爲空!!!!!"); return; } try { Uri uri = Uri.parse(url); Log.i(TAG, String.valueOf(uri)); DownloadManager downloadManager = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE); DownloadManager.Request request = new DownloadManager.Request(uri); // 在通知欄中顯示 request.setVisibleInDownloadsUi(true); request.setTitle(notificationTitle); request.setDescription(descriptInfo); request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED); request.setMimeType("application/vnd.android.package-archive"); String filePath = null; if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {//SD卡是否正常掛載 filePath = Environment.getExternalStorageDirectory().getAbsolutePath(); } else { Log.i(TAG, "沒有SD卡" + "filePath:" + context.getFilesDir().getAbsolutePath()); return; } downloadUpdateApkFilePath = filePath + File.separator + fileName; // 若存在,則刪除 deleteFile(downloadUpdateApkFilePath); Uri fileUri = Uri.parse("file://" + downloadUpdateApkFilePath); request.setDestinationUri(fileUri); downloadUpdateApkId = downloadManager.enqueue(request); } catch (Exception e) { e.printStackTrace(); } }
request.setVisibleInDownloadsUi
下載UI顯示到通知欄上
request.setTitle
設置通知欄的標題
request.setDescription
設置通知欄的消息
request.setNotificationVisibility
下載過程當中一直顯示下載信息,下載完後也存在(直到用戶消除)
會清除沒完成的文件,從新下載。
DownloadManager 下載過程當中(下載完成)會發出廣播,想要對下載完成進行處理須要監聽廣播。
(downloadUpdateApkFilePath 保存下載文件的路徑,下載完成後能夠經過此進行安裝)
DownloadManager 下載完成後會發出 ACTION_DOWNLOAD_COMPLETE。
public class UpdateAppReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { Cursor cursor = null; try { if (! intent.getAction().equals(DownloadManager.ACTION_DOWNLOAD_COMPLETE)) { return; } if (DownloadAppUtil.downloadUpdateApkId <= 0) { return; } long downloadId = DownloadAppUtil.downloadUpdateApkId; DownloadManager.Query query = new DownloadManager.Query(); query.setFilterById(downloadId); DownloadManager manager = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE); cursor = manager.query(query); if (cursor.moveToNext()) { int staus = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS)); if (staus == DownloadManager.STATUS_FAILED) { manager.remove(downloadId); } else if ((staus == DownloadManager.STATUS_SUCCESSFUL) && (DownloadAppUtil.downloadUpdateApkFilePath != null)) { Intent it = new Intent(Intent.ACTION_VIEW); it.setDataAndType(Uri.parse("file://" + DownloadAppUtil.downloadUpdateApkFilePath), "application/vnd.android.package-archive"); // todo 針對不一樣的手機 以及 sdk 版本, 這裏的 uri 地址可能有所不一樣 it.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); context.startActivity(it); } } } catch (Exception e) { e.printStackTrace(); } finally { if (cursor != null) { cursor.close(); } } } }
判斷是 DownloadManager.ACTION_DOWNLOAD_COMPLETE 獲取 APK 路徑進行安裝。
app在線更新是一個比較常見需求,新版本發佈時,用戶進入咱們的app,就會彈出更新提示框,第一時間更新新版本app。在線更新分爲如下幾個步驟:
1, 經過接口獲取線上版本號,versionCode 2, 比較線上的versionCode 和本地的versionCode,彈出更新窗口 3, 下載APK文件(文件下載) 4,安裝APK
在線更新就上面幾個步驟,前2步比較簡單,重要的就是後2個步驟,而因爲Android 各個版本對權限和隱私的收歸和保護,所以,會出現各類的適配問題,所以本文就總結一下app 在線更新方法和遇到的一些適配問題。
apk下載其實就是文件下載,而文件下載有不少方式:
1,不少三方框架都有文件上傳下載功能,能夠藉助三方框架(好比Volley,OkHttp) 2,也能夠開啓一個線程去下載,(能夠用IntentService) 3,最簡單的一種方式:Android SDK 其實給咱們提供了下載類DownloadManager,只須要簡單的配置項設置,就能輕鬆實現下載功能。
本文就用第三種方式,用 DownloadManager
來下載apk。
1. 使用DownloadManager
下載apk
DownloadManager 是SDK 自帶的,大概流程以下:
(1)建立一個Request,進行簡單的配置(下載地址,和文件保存地址等)
(2)下載完成後,系統會發送一個下載完成的廣播,咱們須要監聽廣播。
(3)監聽到下載完成的廣播後,根據id查找下載的apk文件
(4)在代碼中執行apk安裝。
public void downloadApk(String apkUrl, String title, String desc) { // fix bug : 裝不了新版本,在下載以前應該刪除已有文件 File apkFile = new File(weakReference.get().getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS), "test.apk"); if (apkFile != null && apkFile.exists()) { apkFile.delete(); } DownloadManager.Request request = new DownloadManager.Request(Uri.parse(apkUrl)); //設置title request.setTitle(title); // 設置描述 request.setDescription(desc); // 完成後顯示通知欄 request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED); request.setDestinationInExternalFilesDir(weakReference.get(), Environment.DIRECTORY_DOWNLOADS, "test.apk"); //在手機SD卡上建立一個download文件夾 // Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).mkdir() ; //指定下載到SD卡的/download/my/目錄下 // request.setDestinationInExternalPublicDir("/codoon/","test.apk"); request.setMimeType("application/vnd.android.package-archive"); //記住reqId mReqId = mDownloadManager.enqueue(request); }
如上代碼所示,首先構建一個Request,設置下載地址,標題、描述、apk存放目錄等,最後,調用mDownloadManager.enqueue(request)
開始下載。
注意:這裏咱們須要記住這個
mReqId
,由於下載完成以後,咱們須要根據這個ID 去查找apk文件,而後安裝apk.
2.更新下載進度
下載文件,咱們通常須要知道下載的進度,在界面給用戶一個友好的提示,app 更新也是同樣,咱們須要在界面上顯示當前下載進度和總進度,讓用戶知道大概會等待多久。那麼若是獲取下載進度呢?
在下載以前,咱們須要在Activity 中註冊一個Observer,就是一個觀察者,當下載進度變化的時候,就會通知觀察者,從而更新進度。步驟以下:
1, 首先咱們先定義一個觀察者DownloadChangeObserver來觀察下載進度 2,在DownloadChangeObserver 中更新UI進度,給用戶提示 3,下載以前,在Activity 中註冊Observer
具體代碼以下:
DownloadChangeObserver.class
:
class DownloadChangeObserver extends ContentObserver { /** * Creates a content observer. * * @param handler The handler to run {@link #onChange} on, or null if none. */ public DownloadChangeObserver(Handler handler) { super(handler); } @Override public void onChange(boolean selfChange) { super.onChange(selfChange); updateView(); } }
在updateView()
方法中,查詢下載進度。
private void updateView() { int[] bytesAndStatus = new int[]{0, 0, 0}; DownloadManager.Query query = new DownloadManager.Query().setFilterById(mReqId); Cursor c = null; try { c = mDownloadManager.query(query); if (c != null && c.moveToFirst()) { //已經下載的字節數 bytesAndStatus[0] = c.getInt(c.getColumnIndexOrThrow(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR)); //總需下載的字節數 bytesAndStatus[1] = c.getInt(c.getColumnIndexOrThrow(DownloadManager.COLUMN_TOTAL_SIZE_BYTES)); //狀態所在的列索引 bytesAndStatus[2] = c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS)); } } finally { if (c != null) { c.close(); } } if (mUpdateListener != null) { mUpdateListener.update(bytesAndStatus[0], bytesAndStatus[1]); } Log.i(TAG, "下載進度:" + bytesAndStatus[0] + "/" + bytesAndStatus[1] + ""); }
根據前面咱們記錄的ID去查詢進度,代碼中已經註釋了,再也不多講。
要想獲取到進度,在下載以前,還得先註冊DownloadChangeObserver,代碼以下:
weakReference.get().getContentResolver().registerContentObserver(Uri.parse("content://downloads/my_downloads"), true, mDownLoadChangeObserver);
3. 獲取下載結果
DownloadManager
在下載完成以後,會發送一個下載完成的廣播DownloadManager.ACTION_DOWNLOAD_COMPLETE
,咱們只須要監聽這個廣播,收到廣播後, 獲取apk文件安裝。
定義一個廣播DownloadReceiver
。
class DownloadReceiver extends BroadcastReceiver { @Override public void onReceive(final Context context, final Intent intent) { // 安裝APK long completeDownLoadId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1); Logger.e(TAG, "收到廣播"); Uri uri; Intent intentInstall = new Intent(); intentInstall.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); intentInstall.setAction(Intent.ACTION_VIEW); if (completeDownLoadId == mReqId) { uri = mDownloadManager.getUriForDownloadedFile(completeDownLoadId); } intentInstall.setDataAndType(uri, "application/vnd.android.package-archive"); context.startActivity(intentInstall); } }
在下載以前註冊廣播
// 註冊廣播,監聽APK是否下載完成 weakReference.get().registerReceiver(mDownloadReceiver, new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));
經過上面的幾個步驟,基本上就完成app在線更新功能,在Android 6.0如下能夠正常運行。可是別忙,本文尚未結束,Android每個版本都有一些改動,致使咱們須要適配不一樣的版本,否則的話,就會出問題,結下來就看一下Android 6.0,7.0,8.0 的相關適配。
經過前面講的幾個步驟,app 在線更新在6.0如下已經能夠正常運行,在Android6.0上,安裝的時候會報出如下錯誤:
Caused by:
5 android.content.ActivityNotFoundException:No Activity found to handle Intent { act=android.intent.action.VIEW typ=application/vnd.android.package-archive flg=0x10000000 }
爲何會報上面的錯誤,通過debug發現,在Android6.0如下和Android6.0上,經過DownloadManager 獲取到的Uri不同。
區別以下:(1)Android 6.0,getUriForDownloadedFile獲得 值爲: content://downloads/my_downloads/10
(2) Android6.0如下,getUriForDownloadedFile獲得的值爲:file:///storage/emulated/0/Android/data/packgeName/files/Download/xxx.apk
能夠看到,Android6.0獲得的apk地址爲:content:// 開頭的一個地址,安裝的時候就會報上面的錯誤。怎麼解決呢?通過查找資料找到了解決辦法:
//經過downLoadId查詢下載的apk,解決6.0之後安裝的問題 public static File queryDownloadedApk(Context context, long downloadId) { File targetApkFile = null; DownloadManager downloader = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE); if (downloadId != -1) { DownloadManager.Query query = new DownloadManager.Query(); query.setFilterById(downloadId); query.setFilterByStatus(DownloadManager.STATUS_SUCCESSFUL); Cursor cur = downloader.query(query); if (cur != null) { if (cur.moveToFirst()) { String uriString = cur.getString(cur.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI)); if (!TextUtils.isEmpty(uriString)) { targetApkFile = new File(Uri.parse(uriString).getPath()); } } cur.close(); } } return targetApkFile; }
代碼如上所示,不經過getUriForDownloadedFile
去獲取Uri,經過DownloadManager.COLUMN_LOCAL_URI
這個字段去獲取apk地址。
適配Android 6.0後,安裝apk 的代碼以下:
/** * @param context * @param intent */ private void installApk(Context context, Intent intent) { long completeDownLoadId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1); Logger.e(TAG, "收到廣播"); Uri uri; Intent intentInstall = new Intent(); intentInstall.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); intentInstall.setAction(Intent.ACTION_VIEW); if (completeDownLoadId == mReqId) { if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) { // 6.0如下 uri = mDownloadManager.getUriForDownloadedFile(completeDownLoadId); } else if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) { // 6.0 - 7.0 File apkFile = queryDownloadedApk(context, completeDownLoadId); uri = Uri.fromFile(apkFile); } // 安裝應用 Logger.e("zhouwei", "下載完成了"); intentInstall.setDataAndType(uri, "application/vnd.android.package-archive"); context.startActivity(intentInstall); } }
剛適配完6.0,在7.0以上的機子上又出問題了,爲何呢?由於在Android 7.0上,對文件的訪問權限做出了修改,不能在使用file://
格式的Uri 訪問文件 ,Android 7.0提供 FileProvider,應該使用這個來獲取apk地址,而後安裝apk。以下進行簡單的適配:
(1) 在res 目錄下,新建一個xml
文件夾,在xml
下面建立一個文件provider_paths
文件:
<?xml version="1.0" encoding="utf-8"?> <paths> <external-path name="external" path="" /> <external-files-path name="Download" path="" /> </paths>
(2) 在AndroidManifest.xml
清單文件中申明Provider:
<!-- Android 7.0 照片、APK下載保存路徑--> <provider android:name="android.support.v4.content.FileProvider" android:authorities="packgeName.fileProvider" android:exported="false" android:grantUriPermissions="true"> <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/provider_paths" /> </provider>
(3) Android 7.0上的文件地址獲取:
uri = FileProvider.getUriForFile(context,
"packageNam.fileProvider", new File(context.getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS), "xxx.apk"));
好了,就這樣7.0適配工做就完成了,適配後的安裝代碼以下:
/** * @param context * @param intent */ private void installApk(Context context, Intent intent) { long completeDownLoadId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1); Logger.e(TAG, "收到廣播"); Uri uri; Intent intentInstall = new Intent(); intentInstall.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); intentInstall.setAction(Intent.ACTION_VIEW); if (completeDownLoadId == mReqId) { if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) { // 6.0如下 uri = mDownloadManager.getUriForDownloadedFile(completeDownLoadId); } else if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) { // 6.0 - 7.0 File apkFile = queryDownloadedApk(context, completeDownLoadId); uri = Uri.fromFile(apkFile); } else { // Android 7.0 以上 uri = FileProvider.getUriForFile(context, "packgeName.fileProvider", new File(context.getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS), "xxx.apk")); intentInstall.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION); } // 安裝應用 Logger.e("zhouwei", "下載完成了"); intentInstall.setDataAndType(uri, "application/vnd.android.package-archive"); context.startActivity(intentInstall); } }
注意:把上面的packageNam 換成你本身的包名,把xxx.apk 換成你本身的apk的名字。
關於更多FileProvider的東西,這兒就不展開講了,想要了解的能夠看一下鴻洋的文章:Android 7.0 行爲變動 經過FileProvider在應用間共享文件吧
,講的很清楚。
好特麼累,繼續適配Android 8.0, 因爲沒有Android 8.0的手機,一直沒有注意,前些天一個華爲用戶反饋在線更新不了新版本,具體表現就是:apk下載完成,一閃而過,沒有跳轉到apk安裝界面。通過排查,肯定了是Android 8.0權限問題。
Android8.0以上,未知來源的應用是不能夠經過代碼來執行安裝的(在sd卡中找找到apk,手動安裝是能夠的),未知應用安裝權限的開關被除掉,取而代之的是未知來源應用的管理列表,須要列表裏面開啓你的應用的未知來源的安裝權限。Google這麼作是爲了防止一開始正經的應用後來開始經過升級來作一些不合法的事情,侵犯用戶權益。
知道問題了,咱們就適配吧:
(1) 在清單文件中申明權限:REQUEST_INSTALL_PACKAGES
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
(2) 在代碼中判斷用戶是否已經受過權限了,若是已經受權,能夠直接安裝,若是沒有受權,則跳轉到受權列表,讓用戶開啓未知來源應用安裝權限,開啓後,再安裝應用。
在監聽apk下載狀態的廣播中添加以下代碼:
boolean haveInstallPermission; // 兼容Android 8.0 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { //先獲取是否有安裝未知來源應用的權限 haveInstallPermission = context.getPackageManager().canRequestPackageInstalls(); if (!haveInstallPermission) {//沒有權限 // 彈窗,並去設置頁面受權 final AndroidOInstallPermissionListener listener = new AndroidOInstallPermissionListener() { @Override public void permissionSuccess() { installApk(context, intent); } @Override public void permissionFail() { ToastUtils.shortToast(context, "受權失敗,沒法安裝應用"); } }; AndroidOPermissionActivity.sListener = listener; Intent intent1 = new Intent(context, AndroidOPermissionActivity.class); context.startActivity(intent1); } else { installApk(context, intent); } } else { installApk(context, intent); }
由於受權時須要彈框提示,咱們用一個Activity來代理建立了一個Activity:AndroidOPermissionActivity
來申請權限,用戶點擊設置後,跳轉到權限設置界面,而後咱們再onActivityResult
裏判斷是都受權成功。
AndroidOPermissionActivity
代碼以下:
/** * 兼容Android 8。0 APP 在線更新,權限申請界面 * Created by zhouwei on 2018/3/23. */ public class AndroidOPermissionActivity extends BaseActivity { public static final int INSTALL_PACKAGES_REQUESTCODE = 1; private AlertDialog mAlertDialog; public static AppDownloadManager.AndroidOInstallPermissionListener sListener; @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // 彈窗 if (Build.VERSION.SDK_INT >= 26) { ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.REQUEST_INSTALL_PACKAGES}, INSTALL_PACKAGES_REQUESTCODE); } else { finish(); } } @RequiresApi(api = Build.VERSION_CODES.O) @Override public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) { super.onRequestPermissionsResult(requestCode, permissions, grantResults); switch (requestCode) { case INSTALL_PACKAGES_REQUESTCODE: if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) { if (sListener != null) { sListener.permissionSuccess(); finish(); } } else { //startInstallPermissionSettingActivity(); showDialog(); } break; } } private void showDialog() { AlertDialog.Builder builder = new AlertDialog.Builder(this); builder.setTitle(R.string.app_name); builder.setMessage("爲了正常升級 xxx APP,請點擊設置按鈕,容許安裝未知來源應用,本功能只限用於 xxx APP版本升級"); builder.setPositiveButton("設置", new DialogInterface.OnClickListener() { @RequiresApi(api = Build.VERSION_CODES.O) @Override public void onClick(DialogInterface dialogInterface, int i) { startInstallPermissionSettingActivity(); mAlertDialog.dismiss(); } }); builder.setNegativeButton("取消", new DialogInterface.OnClickListener() { @Override public void onClick(DialogInterface dialogInterface, int i) { if (sListener != null) { sListener.permissionFail(); } mAlertDialog.dismiss(); finish(); } }); mAlertDialog = builder.create(); mAlertDialog.show(); } @RequiresApi(api = Build.VERSION_CODES.O) private void startInstallPermissionSettingActivity() { //注意這個是8.0新API Intent intent = new Intent(Settings.ACTION_MANAGE_UNKNOWN_APP_SOURCES, Uri.parse("package:" + getPackageName())); startActivityForResult(intent, 1); } @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); if (requestCode == 1 && resultCode == RESULT_OK) { // 受權成功 if (sListener != null) { sListener.permissionSuccess(); } } else { // 受權失敗 if (sListener != null) { sListener.permissionFail(); } } finish(); } @Override protected void onDestroy() { super.onDestroy(); sListener = null; } }
注意:當經過Intent 跳轉到未知應用受權列表的時候,必定要加上包名,這樣就能直接跳轉到你的app下,否則只能跳轉到列表。
好了,這樣Android 8.0 上也能夠在線更新了。
AppDownloadManager
爲了避免依賴於某個Activity ,所以封裝了一個AppDownloadManager
,少許幾行代碼就能夠實如今線更新,給出完整代碼:
public class AppDownloadManager { public static final String TAG = "AppDownloadManager"; private WeakReference<Activity> weakReference; private DownloadManager mDownloadManager; private DownloadChangeObserver mDownLoadChangeObserver; private DownloadReceiver mDownloadReceiver; private long mReqId; private OnUpdateListener mUpdateListener; public AppDownloadManager(Activity activity) { weakReference = new WeakReference<Activity>(activity); mDownloadManager = (DownloadManager) weakReference.get().getSystemService(Context.DOWNLOAD_SERVICE); mDownLoadChangeObserver = new DownloadChangeObserver(new Handler()); mDownloadReceiver = new DownloadReceiver(); } public void setUpdateListener(OnUpdateListener mUpdateListener) { this.mUpdateListener = mUpdateListener; } public void downloadApk(String apkUrl, String title, String desc) { // fix bug : 裝不了新版本,在下載以前應該刪除已有文件 File apkFile = new File(weakReference.get().getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS), "app_name.apk"); if (apkFile != null && apkFile.exists()) { apkFile.delete(); } DownloadManager.Request request = new DownloadManager.Request(Uri.parse(apkUrl)); //設置title request.setTitle(title); // 設置描述 request.setDescription(desc); // 完成後顯示通知欄 request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED); request.setDestinationInExternalFilesDir(weakReference.get(), Environment.DIRECTORY_DOWNLOADS, "app_name.apk"); //在手機SD卡上建立一個download文件夾 // Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).mkdir() ; //指定下載到SD卡的/download/my/目錄下 // request.setDestinationInExternalPublicDir("/codoon/","codoon_health.apk"); request.setMimeType("application/vnd.android.package-archive"); // mReqId = mDownloadManager.enqueue(request); } /** * 取消下載 */ public void cancel() { mDownloadManager.remove(mReqId); } /** * 對應 {@link Activity } */ public void resume() { //設置監聽Uri.parse("content://downloads/my_downloads") weakReference.get().getContentResolver().registerContentObserver(Uri.parse("content://downloads/my_downloads"), true, mDownLoadChangeObserver); // 註冊廣播,監聽APK是否下載完成 weakReference.get().registerReceiver(mDownloadReceiver, new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE)); } /** * 對應{@link Activity#onPause()} ()} */ public void onPause() { weakReference.get().getContentResolver().unregisterContentObserver(mDownLoadChangeObserver); weakReference.get().unregisterReceiver(mDownloadReceiver); } private void updateView() { int[] bytesAndStatus = new int[]{0, 0, 0}; DownloadManager.Query query = new DownloadManager.Query().setFilterById(mReqId); Cursor c = null; try { c = mDownloadManager.query(query); if (c != null && c.moveToFirst()) { //已經下載的字節數 bytesAndStatus[0] = c.getInt(c.getColumnIndexOrThrow(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR)); //總需下載的字節數 bytesAndStatus[1] = c.getInt(c.getColumnIndexOrThrow(DownloadManager.COLUMN_TOTAL_SIZE_BYTES)); //狀態所在的列索引 bytesAndStatus[2] = c.getInt(c.getColumnIndex(DownloadManager.COLUMN_STATUS)); } } finally { if (c != null) { c.close(); } } if (mUpdateListener != null) { mUpdateListener.update(bytesAndStatus[0], bytesAndStatus[1]); } Log.i(TAG, "下載進度:" + bytesAndStatus[0] + "/" + bytesAndStatus[1] + ""); } class DownloadChangeObserver extends ContentObserver { /** * Creates a content observer. * * @param handler The handler to run {@link #onChange} on, or null if none. */ public DownloadChangeObserver(Handler handler) { super(handler); } @Override public void onChange(boolean selfChange) { super.onChange(selfChange); updateView(); } } class DownloadReceiver extends BroadcastReceiver { @Override public void onReceive(final Context context, final Intent intent) { boolean haveInstallPermission; // 兼容Android 8.0 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { //先獲取是否有安裝未知來源應用的權限 haveInstallPermission = context.getPackageManager().canRequestPackageInstalls(); if (!haveInstallPermission) {//沒有權限 // 彈窗,並去設置頁面受權 final AndroidOInstallPermissionListener listener = new AndroidOInstallPermissionListener() { @Override public void permissionSuccess() { installApk(context, intent); } @Override public void permissionFail() { ToastUtils.shortToast(context, "受權失敗,沒法安裝應用"); } }; AndroidOPermissionActivity.sListener = listener; Intent intent1 = new Intent(context, AndroidOPermissionActivity.class); context.startActivity(intent1); } else { installApk(context, intent); } } else { installApk(context, intent); } } } /** * @param context * @param intent */ private void installApk(Context context, Intent intent) { long completeDownLoadId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1); Logger.e(TAG, "收到廣播"); Uri uri; Intent intentInstall = new Intent(); intentInstall.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); intentInstall.setAction(Intent.ACTION_VIEW); if (completeDownLoadId == mReqId) { if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) { // 6.0如下 uri = mDownloadManager.getUriForDownloadedFile(completeDownLoadId); } else if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) { // 6.0 - 7.0 File apkFile = queryDownloadedApk(context, completeDownLoadId); uri = Uri.fromFile(apkFile); } else { // Android 7.0 以上 uri = FileProvider.getUriForFile(context, "package_name.fileProvider", new File(context.getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS), "app_name.apk")); intentInstall.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION); } // 安裝應用 Logger.e("zhouwei", "下載完成了"); intentInstall.setDataAndType(uri, "application/vnd.android.package-archive"); context.startActivity(intentInstall); } } //經過downLoadId查詢下載的apk,解決6.0之後安裝的問題 public static File queryDownloadedApk(Context context, long downloadId) { File targetApkFile = null; DownloadManager downloader = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE); if (downloadId != -1) { DownloadManager.Query query = new DownloadManager.Query(); query.setFilterById(downloadId); query.setFilterByStatus(DownloadManager.STATUS_SUCCESSFUL); Cursor cur = downloader.query(query); if (cur != null) { if (cur.moveToFirst()) { String uriString = cur.getString(cur.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI)); if (!TextUtils.isEmpty(uriString)) { targetApkFile = new File(Uri.parse(uriString).getPath()); } } cur.close(); } } return targetApkFile; } public interface OnUpdateListener { void update(int currentByte, int totalByte); } public interface AndroidOInstallPermissionListener { void permissionSuccess(); void permissionFail(); } }
使用就很簡單了,以下:
(1) 彈出更新提示框:提示用戶更新
private void showUpdateDialog(final AppUpdateInfo updateInfo) { AppUpdateDialog dialog = new AppUpdateDialog(getContext()); dialog.setAppUpdateInfo(updateInfo); dialog.setOnUpdateClickListener(new AppUpdateDialog.OnUpdateClickListener() { @Override public void update(final AppUpdateDialog updateDialog) { String title = "app name"; String desc = "版本更新"; mDownloadManager.setUpdateListener(new AppDownloadManager.OnUpdateListener() { @Override public void update(int currentByte, int totalByte) { updateDialog.setProgress(currentByte, totalByte); if ((currentByte == totalByte) && totalByte != 0) { updateDialog.dismiss(); } } }); mDownloadManager.downloadApk(updateInfo.download_url, title, desc); } }); dialog.setCanceledOnTouchOutside(false); dialog.setCancelable(false); dialog.show(); }
(2) 注意在 onResume
和 onPause 調用對應方法:
@Override public void onResume() { super.onResume(); if (mDownloadManager != null) { mDownloadManager.resume(); } }
@Override public void onPause() { super.onPause(); if (mDownloadManager != null) { mDownloadManager.onPause(); } }
本文總結了項目中app在線更新遇到的一些適配問題,關於Android 6.0 的適配,若是你沒有使用DownloadManager,可能不會遇到這個問題。7.0 和 8.0 的適配無論用哪一種方式,都會有。
關於app在線更新版本適配就此結束,若是有啥問題,歡迎指出。
評論區有不少要AppUpdateDialog代碼,其實沒啥參考的,就一個自定義Dialog,我仍是貼出來吧
public class AppUpdateDialog extends HeaderBaseDialog implements View.OnClickListener { private String mContent; private AppUpdateInfo mAppUpdateInfo; private OnUpdateClickListener mOnUpdateListener; private ProgressBar mProgressBar; private TextView mValueText; private boolean mForceUpdate = true; public AppUpdateDialog(@NonNull Context context) { super(context); } public void setContent(String mContent) { this.mContent = mContent; } public void setAppUpdateInfo(AppUpdateInfo mAppUpdateInfo) { this.mAppUpdateInfo = mAppUpdateInfo; } public void setProgress(int progress, int maxValue) { if (maxValue == 0) { return; } mProgressBar.setMax(maxValue); mProgressBar.setProgress(progress); mValueText.setText((int) (progress * 1.0f / maxValue * 100) + "%"); } public void setOnUpdateClickListener(OnUpdateClickListener mOnUpdateListener) { this.mOnUpdateListener = mOnUpdateListener; } @Override protected void initView() { setCanceledOnTouchOutside(false); if (mAppUpdateInfo.force_update) { mForceUpdate = true; } else { mForceUpdate = false; } TextView textView = (TextView) findViewById(R.id.app_update_content); TextView version = (TextView) findViewById(R.id.app_update_version); mProgressBar = (ProgressBar) findViewById(R.id.app_update_progress); mValueText = (TextView) findViewById(R.id.app_update_current_percent); version.setText(mAppUpdateInfo.version + " 更新內容"); textView.setText(mAppUpdateInfo.note); TextView btnUpdate = (TextView) findViewById(R.id.btn_app_update); btnUpdate.setText("更新"); btnUpdate.setOnClickListener(this); } @Override protected int getHeaderLayout() { return R.layout.app_update_header_layout; } @Override protected int getContentLayout() { return R.layout.app_update_content_layout; } @Override protected Drawable getBgDrawable() { return null; } @Override protected int getStartColor() { return getContext().getResources().getColor(R.color.body_weight_start_color); } @Override protected int getEndColor() { return getContext().getResources().getColor(R.color.body_weight_end_color); } @Override protected boolean isShowClose() { return !mForceUpdate; } @Override public void onClick(View v) { // update if (mOnUpdateListener != null) { findViewById(R.id.update_progress_layout).setVisibility(View.VISIBLE); findViewById(R.id.btn_app_update).setVisibility(View.GONE); mOnUpdateListener.update(this); } } public interface OnUpdateClickListener { void update(AppUpdateDialog dialog); } }