“强制升级”会中断用户操作,阻碍正常使用,看似是一个不光彩的行为,但是智者千虑必有一失,我们无法保证 App 的正确性,在某些紧急情况下,强制升级还是非常必要的,而且接入的时间越早越好。
有赞微商城 App 早期版本只提供了一个更新提示的对话框,并不会强制用户更新。随着后端网关升级,一些老的服务需要下线,但是新版本到达率并不理想,继续维护老接口带来一定成本,而且新功能也无法触及用户。
为了提升版本到达率,我们重新梳理了强制升级的逻辑。
升级过程中首先要保证 apk 的下载成功率,下载完成之后要及时弹出安装页面,为了防止下载失败,也要提供市场下载的选项,这样一定程度上也能保证升级之后渠道的一致性。
更新对话框需要展示标题、内容和动作按钮。
状态栏下载通知需要展示应用名字和描述。
构造参数
业务方需要提供的参数:
public class AppUpdater {
public static class Builder {
private Context context;
private String url; // apk 下载链接
private String title; // 更新对话框 title
private String content; // 更新内容
private boolean force; // 是否强制更新
private String app; // app 名字
private String description; // app 描述
}
private AppUpdater(final Builder builder) {
this.builder = builder;
}
public void update() {
Intent intent = new Intent(builder.context, DownloadActivity.class);
intent.putExtra(DownloadActivity.EXTRA_STRING_APP_NAME, builder.app);
intent.putExtra(DownloadActivity.EXTRA_STRING_URL, builder.url);
intent.putExtra(DownloadActivity.EXTRA_STRING_TITLE, builder.title);
intent.putExtra(DownloadActivity.EXTRA_STRING_CONTENT, builder.content);
intent.putExtra(DownloadActivity.EXTRA_STRING_DESCRIPTION, builder.description);
intent.putExtra(DownloadActivity.EXTRA_BOOLEAN_FORCE, builder.force);
builder.context.startActivity(intent);
}
使用 DownloadManager 下载 apk
为了提高下载成功率,我们使用了系统 Service - DownloadManager,因为是独立进程,不会增加 App 占用的系统开销。
private void downloadApk() {
if (TextUtils.isEmpty(downloadUrl)) return;
// check dir
File path = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
if (!path.exists() && !path.mkdirs()) {
Toast.makeText(this, String.format(getString(R.string.app_updater_dir_not_found),
path.getPath()), Toast.LENGTH_SHORT).show();
return;
}
/** construct request */
final DownloadManager.Request request = new DownloadManager.Request(Uri.parse(downloadUrl));
request.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE
| DownloadManager.Request.NETWORK_WIFI);
request.setAllowedOverRoaming(false);
request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS,
appName + ".apk");
if (!TextUtils.isEmpty(appName)) {
request.setTitle(appName);
}
if (!TextUtils.isEmpty(description)) {
request.setDescription(description);
} else {
request.setDescription(downloadUrl);
}
/** start downloading */
downloadId = downloadManager.enqueue(request);
setStatus(STATUS_DOWNLOADING);
}
注册监听下载完成的 Receiver
我们通过一个全局的 Receiver 来接收下载完成的广播,这样即使 App 进程被杀死,依然可以安装界面。
<receiver
android:name=".DownloadReceiver"
android:enabled="true"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.DOWNLOAD_COMPLETE"/>
</intent-filter>
</receiver>
接收到广播之后,弹出安装界面。
private void installApk(final Context context, final Uri uri) {
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
Uri apkUri = uri;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
apkUri = FileProvider.getUriForFile(context, context.getPackageName() + ".provider",
new File(uri.getPath()));
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION
| Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
}
intent.setDataAndType(apkUri, "application/vnd.android.package-archive");
context.startActivity(intent);
}
注意此处有坑,在 SDK >= 24 的系统中,Intent 不允许携带
file://
格式的数据,只能通过provider
的形式共享数据。
所以我们还需要注册一个 FileProvider
。
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${applicationId}.provider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/provider_paths"/>
</provider>
${applicationId}$
是 AndroidManifest.xml
中的占位符,gradle 会进行替换。
android:authorities="${applicationId}.provider"
对应 Java 代码:
FileProvider.getUriForFile(context, context.getPackageName() + ".provider", new File(uri.getPath()))
注意:Java 代码中 getPackageName()
的返回值是 ApplicationId
。
关于 package name 和 application id 的区别,可以参考 http://blog.csdn.net/feelang/...