Android应用更新-自动检测版本及自动升级

封面图 • 2025-11-21 • Android开发

在 Android 应用中实现**自动检测版本更新**和**自动升级**，是提升用户体验的重要功能之一。以下是一个完整的实现方案，包括：

---

## 一、自动检测版本更新

### 1. 获取当前应用的版本信息
```java
public static int getCurrentVersionCode(Context context) {
    try {
        PackageInfo packageInfo = context.getPackageManager().getPackageInfo(context.getPackageName(), 0);
        return packageInfo.versionCode;
    } catch (PackageManager.NameNotFoundException e) {
        e.printStackTrace();
        return -1;
    }
}
```

### 2. 从服务器获取最新版本信息（如通过 HTTP API）
你可以使用 `Retrofit` 或 `OkHttp` 发起网络请求。

#### 示例（使用 OkHttp）：
```java
public void checkForUpdate() {
    OkHttpClient client = new OkHttpClient();
    Request request = new Request.Builder()
            .url("https://yourserver.com/api/check-update")
            .build();

client.newCall(request).enqueue(new Callback() {
        @Override
        public void onFailure(Call call, IOException e) {
            // 网络失败
            Log.e("UpdateCheck", "Failed to check for update: " + e.getMessage());
        }

@Override
        public void onResponse(Call call, Response response) throws IOException {
            if (response.isSuccessful()) {
                String responseBody = response.body().string();
                try {
                    JSONObject json = new JSONObject(responseBody);
                    int latestVersionCode = json.getInt("version_code");
                    String downloadUrl = json.getString("download_url");

int currentVersionCode = getCurrentVersionCode(context);

if (latestVersionCode > currentVersionCode) {
                        // 需要更新
                        showUpdateDialog(downloadUrl);
                    } else {
                        // 当前已是最新版本
                        Toast.makeText(context, "当前已是最新版本", Toast.LENGTH_SHORT).show();
                    }
                } catch (JSONException e) {
                    e.printStackTrace();
                }
            }
        }
    });
}
```

---

## 二、自动升级（下载并安装 APK）

### 1. 显示更新提示对话框
```java
private void showUpdateDialog(String downloadUrl) {
    new AlertDialog.Builder(context)
            .setTitle("发现新版本")
            .setMessage("是否立即更新？")
            .setPositiveButton("确定", (dialog, which) -> {
                downloadAndInstallApk(downloadUrl);
            })
            .setNegativeButton("取消", null)
            .show();
}
```

### 2. 下载 APK 文件
```java
private void downloadAndInstallApk(String url) {
    DownloadManager.Request request = new DownloadManager.Request(Uri.parse(url));
    request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
    request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, "app_update.apk");

DownloadManager downloadManager = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE);
    long downloadId = downloadManager.enqueue(request);

// 监听下载完成
    BroadcastReceiver receiver = new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
            long id = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);
            if (id == downloadId) {
                installApk();
            }
        }
    };

context.registerReceiver(receiver, new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));
}
```

### 3. 安装 APK
```java
private void installApk() {
    File apkFile = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS), "app_update.apk");
    if (apkFile.exists()) {
        Uri uri = FileProvider.getUriForFile(context, "com.yourpackage.fileprovider", apkFile);
        Intent intent = new Intent(Intent.ACTION_INSTALL_PACKAGE);
        intent.setData(uri);
        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        context.startActivity(intent);
    }
}
```

---

## 三、权限配置（AndroidManifest.xml）

确保添加以下权限：

```xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

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

### file_paths.xml（放在 res/xml/ 目录下）：
```xml
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path name="downloads" path="Download" />
</paths>
```

---

## 四、注意事项

1. **Android 11 及以上系统**：需要使用 `Scoped Storage`，可能需要使用 `MediaStore` 或 `Downloads` 目录。
2. **用户授权**：安装 APK 需要用户授权，不能完全自动化，但可以引导用户操作。
3. **安全性**：确保下载链接是 HTTPS，并验证 APK 的签名或哈希值，防止中间人攻击。

---

## 五、推荐方式（更现代）

如果你希望更现代化的方式，可以考虑使用 [Firebase App Distribution](https://firebase.google.com/docs/app-distribution) 或 [Google Play Console 内部测试轨道](https://support.google.com/googleplay/androidpublish/answer/9227486)，它们提供了更安全、更方便的更新机制。

---

## 六、总结

| 功能 | 实现方式 |
|------|----------|
| 检测版本 | 本地版本 vs 服务器版本 |
| 自动下载 | 使用 `DownloadManager` |
| 自动安装 | 使用 `Intent.ACTION_INSTALL_PACKAGE` |
| 权限 | Internet、Storage、Install Packages |
| 安全性 | HTTPS + 文件校验 |

---

如果你有具体的需求（比如后台检测、静默更新等），我可以进一步优化方案。需要我帮你写一个完整示例项目吗？