企业官网建设流程全解析

1. Android 9.0+自动更新的核心挑战

在Android 9.0（Pie）及更高版本中，系统对隐私和安全性的要求显著提升，这给APP自动更新功能带来了三个关键挑战：

存储访问限制（Scoped Storage）是最明显的改变。以前我们可以随意访问外部存储，现在系统要求应用只能访问自己的专属目录（App-specific目录）和通过Storage Access Framework申请的公共文件。实测发现，如果直接使用旧代码下载APK到SD卡根目录，在Android 10+设备上会直接报错。

安装未知来源应用权限变得更加严格。从Android 8.0开始，不仅需要在AndroidManifest中声明REQUEST_INSTALL_PACKAGES权限，还必须引导用户跳转到系统设置页手动开启权限。我遇到过不少用户投诉"更新按钮点了没反应"，其实就是这个权限没处理好。

FileProvider的配置复杂度也不容忽视。Android 7.0引入的FileProvider机制在9.0后需要更精确的路径配置，特别是当你的应用需要支持多版本Android时，一个配置错误就会导致安装时出现"解析包失败"的报错。

2. 权限管理的正确姿势

2.1 动态权限申请清单

这些是自动更新功能必须申请的权限：

<!-- 网络权限 --> <uses-permission android:name="android.permission.INTERNET" /> <!-- 安装APK权限 --> <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" /> <!-- Android 10以下需要存储权限 --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />

特别注意：从Android 11开始，即使申请了MANAGE_EXTERNAL_STORAGE权限，也无法在根目录创建文件。正确的做法是将APK下载到应用专属目录：

File downloadDir = context.getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS); File apkFile = new File(downloadDir, "update.apk");

2.2 处理未知来源安装权限

这里有个坑：单纯检查canRequestPackageInstalls()是不够的，必须处理用户拒绝授权的场景：

private void checkInstallPermission() { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O && !getPackageManager().canRequestPackageInstalls()) { new AlertDialog.Builder(this) .setTitle("需要安装权限") .setMessage("请允许安装来自此来源的应用") .setPositiveButton("去设置", (d, w) -> { Intent intent = new Intent( Settings.ACTION_MANAGE_UNKNOWN_APP_SOURCES, Uri.parse("package:" + getPackageName()) ); startActivityForResult(intent, INSTALL_PERMISSION_CODE); }) .setNegativeButton("取消", null) .show(); } else { startInstall(); } } @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { if (requestCode == INSTALL_PERMISSION_CODE) { checkInstallPermission(); // 再次检查 } }

3. 文件存储的最佳实践

3.1 适配Scoped Storage的下载方案

推荐使用DownloadManager系统服务，它有三大优势：

1. 不需要处理存储权限问题
2. 支持断点续传
3. 系统会自动显示下载进度通知

DownloadManager.Request request = new DownloadManager.Request(Uri.parse(url)) .setDestinationInExternalFilesDir(this, Environment.DIRECTORY_DOWNLOADS, "update.apk") .setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE); DownloadManager dm = (DownloadManager) getSystemService(DOWNLOAD_SERVICE); long downloadId = dm.enqueue(request); // 监听下载完成 BroadcastReceiver receiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { Uri uri = dm.getUriForDownloadedFile(downloadId); installApk(uri); } }; registerReceiver(receiver, new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));

3.2 FileProvider的完整配置

1. 在AndroidManifest中添加：

<provider android:name="androidx.core.content.FileProvider" android:authorities="${applicationId}.fileprovider" android:exported="false" android:grantUriPermissions="true"> <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths" /> </provider>

2. 创建res/xml/file_paths.xml：

<?xml version="1.0" encoding="utf-8"?> <paths> <!-- 适配Android 10+ --> <external-files-path name="download" path="Download/" /> <!-- 兼容旧版本 --> <external-path name="external" path="." /> </paths>

4. 版本检测与更新流程优化

4.1 智能版本比对策略

不要简单比较versionCode，建议使用语义化版本号比对：

public static boolean shouldUpdate(String serverVersion, String currentVersion) { String[] serverParts = serverVersion.split("\\."); String[] currentParts = currentVersion.split("\\."); for (int i = 0; i < Math.min(serverParts.length, currentParts.length); i++) { int serverNum = Integer.parseInt(serverParts[i]); int currentNum = Integer.parseInt(currentParts[i]); if (serverNum > currentNum) { return true; } else if (serverNum < currentNum) { return false; } } return serverParts.length > currentParts.length; }

4.2 增量更新与文件校验

为提升用户体验，可以增加以下特性：

• MD5校验防止文件损坏

public static boolean verifyApk(File apk, String expectedMd5) { try (InputStream is = new FileInputStream(apk)) { String md5 = DigestUtils.md5Hex(is); return md5.equalsIgnoreCase(expectedMd5); } catch (Exception e) { return false; } }

• 显示友好的更新对话框

void showUpdateDialog(UpdateInfo info) { MaterialAlertDialogBuilder(this) .setTitle("发现新版本 " + info.versionName) .setMessage(info.updateLog) .setPositiveButton("立即更新", (d, w) -> startDownload()) .setNegativeButton("稍后提醒", (d, w) -> remindLater()) .setNeutralButton("忽略此版本", (d, w) -> ignoreVersion()) .show(); }

5. 安装过程的兼容处理

5.1 全版本兼容的安装方法

void installApk(Context context, File apkFile) { Intent intent = new Intent(Intent.ACTION_VIEW); intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { // Android 7.0+ 使用FileProvider Uri apkUri = FileProvider.getUriForFile( context, context.getPackageName() + ".fileprovider", apkFile ); intent.setDataAndType(apkUri, "application/vnd.android.package-archive"); intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); } else { // 传统方式 intent.setDataAndType( Uri.fromFile(apkFile), "application/vnd.android.package-archive" ); } try { context.startActivity(intent); } catch (Exception e) { Toast.makeText(context, "安装失败：" + e.getMessage(), Toast.LENGTH_LONG).show(); } }

5.2 处理Android 11的包可见性

从Android 11开始，查询其他应用信息需要声明包可见性。在AndroidManifest中添加：

<queries> <intent> <action android:name="android.intent.action.VIEW" /> <data android:mimeType="application/vnd.android.package-archive" /> </intent> </queries>

6. 网络请求与安全配置

6.1 允许明文通信

如果更新服务器没有HTTPS，需要在res/xml/network_security_config.xml中配置：

<?xml version="1.0" encoding="utf-8"?> <network-security-config> <domain-config cleartextTrafficPermitted="true"> <domain includeSubdomains="true">yourdomain.com</domain> </domain-config> </network-security-config>

然后在AndroidManifest中引用：

<application android:networkSecurityConfig="@xml/network_security_config" ... >

6.2 处理证书验证

对于自签名证书，可以自定义TrustManager：

public static SSLSocketFactory createSSLSocketFactory() { try { SSLContext context = SSLContext.getInstance("TLS"); context.init(null, new TrustManager[]{ new X509TrustManager() { public void checkClientTrusted(X509Certificate[] chain, String authType) {} public void checkServerTrusted(X509Certificate[] chain, String authType) {} public X509Certificate[] getAcceptedIssuers() { return new X509Certificate[0]; } } }, null); return context.getSocketFactory(); } catch (Exception e) { throw new RuntimeException(e); } }

7. 完整实现示例

以下是整合所有关键点的核心代码：

public class AppUpdater { private static final String APK_NAME = "update.apk"; private static final String PROVIDER_SUFFIX = ".fileprovider"; public static void checkUpdate(Context context, String updateUrl) { if (!isNetworkAvailable(context)) { showToast(context, "网络不可用"); return; } new AsyncTask<Void, Void, UpdateInfo>() { @Override protected UpdateInfo doInBackground(Void... voids) { try { // 实际项目中应该解析JSON响应 HttpURLConnection conn = (HttpURLConnection) new URL(updateUrl).openConnection(); conn.setRequestMethod("GET"); if (conn.getResponseCode() == 200) { InputStream is = conn.getInputStream(); String json = IOUtils.toString(is, StandardCharsets.UTF_8); return parseUpdateInfo(json); } } catch (Exception e) { Log.e("AppUpdater", "检查更新失败", e); } return null; } @Override protected void onPostExecute(UpdateInfo info) { if (info != null && shouldUpdate(info.version, getCurrentVersion(context))) { showUpdateDialog(context, info); } } }.execute(); } public static void startDownload(Context context, String downloadUrl) { File apkFile = new File( context.getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS), APK_NAME ); DownloadManager.Request request = new DownloadManager.Request(Uri.parse(downloadUrl)) .setDestinationUri(Uri.fromFile(apkFile)) .setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED); DownloadManager dm = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE); long downloadId = dm.enqueue(request); // 实际项目中应该保存downloadId用于查询进度 } public static void installApk(Context context) { File apkFile = new File( context.getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS), APK_NAME ); if (!apkFile.exists()) { showToast(context, "安装文件不存在"); return; } if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { if (!context.getPackageManager().canRequestPackageInstalls()) { showInstallPermissionDialog(context); return; } } Intent intent = new Intent(Intent.ACTION_VIEW); intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { Uri apkUri = FileProvider.getUriForFile( context, context.getPackageName() + PROVIDER_SUFFIX, apkFile ); intent.setDataAndType(apkUri, "application/vnd.android.package-archive"); intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); } else { intent.setDataAndType( Uri.fromFile(apkFile), "application/vnd.android.package-archive" ); } try { context.startActivity(intent); } catch (Exception e) { showToast(context, "启动安装失败：" + e.getMessage()); } } // 其他辅助方法... }

8. 避坑指南

在真实项目中踩过的几个典型坑：

1. 文件权限问题：测试发现部分华为设备上安装失败，原因是FileProvider的authorities配置与其他库冲突，解决方案是使用${applicationId}作为前缀：

android:authorities="${applicationId}.fileprovider"

2. 下载目录选择：尝试使用getCacheDir()存储APK会导致安装失败，因为系统安装服务无权访问应用私有目录，必须使用getExternalFilesDir()。

3. Android 11适配：发现查询不到下载完成的APK文件，需要添加<queries>声明并改用ContentResolver查询DownloadManager的下载结果。

4. 厂商ROM兼容：某些小米/OPPO设备会拦截静默安装，需要引导用户关闭"安全守护"之类的功能，这种情况建议增加重试机制和友好提示。