Android实现Android APP自动更新功能_Android

一、项目介绍

在移动应用的全生命周期中，版本迭代和用户更新体验至关重要。传统的做法是依赖 google play 商店强制推送更新，但在某些场景下，我们需要：

更即时地控制更新流程（如灰度、强制升级、提醒升级等）；
支持市场外分发，比如企业内部应用分发、第三方应用商店；
自定义更新 ui，与应用风格保持一致。

本项目示例将展示两种主流方案：

google play in‑app updates（官方方案，适用于上架 play 商店的应用）
自建服务 + apk 下载 & 安装（适用于非 play 分发场景）

通过本教程，你将学会如何在应用内检测新版本、弹出升级对话框、后台下载 apk、以及无缝触发安装流程，极大提升用户体验。

二、相关知识

google play core library
- com.google.android.play:core:1.x.x 包含了 in‑app updates api，让应用可在运行时检查并触发“灵活更新”或“立即更新”流程，无需用户去 play 商店界面。
fileprovider & 安装意图
- 对于自建更新方案，需要在 androidmanifest.xml 配置 fileprovider，并通过 intent.action_view 携带 apk 的 content:// uri，调用系统安装界面。
workmanager / downloadmanager
- 长任务（如后台下载 apk）应使用 workmanager 或系统 downloadmanager，保证下载可在后台稳定运行，且重启后可续传。
运行时权限 & 兼容性
- android 8.0+（api 26+）安装需获取 “允许安装未知应用” 权限 (request_install_packages)。
- android 7.0+（api 24+）文件 uri 必须走 fileprovider，否则会抛 fileuriexposedexception。

三、项目实现思路

版本检测
- play 方案：调用 play core 的 appupdatemanager.getappupdateinfo() 检查更新状态。
- 自建方案：向自有服务器发起网络请求（如 get /latest_version.json），获取最新版本号、apk 下载地址、更新说明等。
弹窗交互
- 根据策略选择“立即更新”（强制）或“灵活更新”（允许后台运行时再重启安装），并展示更新日志。
下载 apk
- play 方案：由 play core 自动下载。
- 自建方案：用 downloadmanager 启动下载，并监听广播获取下载完成通知。
触发安装
- 下载完成后，构造 intent.action_view，指定 mime 类型 application/vnd.android.package-archive，使用 fileprovider 共享 apk uri，启动安装流程。

四、完整代码（all‑in‑one，含详细注释）

// =======================================
// 文件: autoupdatemanager.java + mainactivity
// （本示例将 manager 与 activity 合写于一处，注释区分）
// =======================================
 
package com.example.autoupdate;
 
import android.manifest;
import android.app.activity;
import android.app.alertdialog;
import android.app.downloadmanager;
import android.content.activitynotfoundexception;
import android.content.broadcastreceiver;
import android.content.context;
import android.content.dialoginterface;
import android.content.intent;
import android.content.intentfilter;
import android.content.pm.packagemanager;
import android.content.res.configuration;
import android.net.uri;
import android.os.build;
import android.os.environment;
import androidx.annotation.nonnull;
import androidx.appcompat.app.appcompatactivity;
import androidx.core.app.activitycompat;
import androidx.core.content.fileprovider;
 
import android.os.bundle;
import android.util.log;
import android.view.view;
import android.widget.button;
import android.widget.toast;
 
// —— play core 库依赖（立即更新/灵活更新）
// implementation "com.google.android.play:core:1.10.3"
import com.google.android.play.core.appupdate.appupdateinfo;
import com.google.android.play.core.appupdate.appupdatemanagerfactory;
import com.google.android.play.core.install.model.appupdatetype;
import com.google.android.play.core.install.model.updateavailability;
import com.google.android.play.core.tasks.task;
 
import org.json.jsonobject;
 
import java.io.file;
import java.io.inputstream;
import java.net.httpurlconnection;
import java.net.url;
import java.util.scanner;
 
public class mainactivity extends appcompatactivity {
 
    // ---------- 常量区 ----------
    private static final int request_code_update = 100;               // play 更新请求码
    private static final int request_install_permission = 101;        // 动态安装权限
    private static final string tag = "autoupdate";
    private long downloadid;                                          // downloadmanager 返回 id
    private downloadmanager downloadmanager;
 
    // ---------- oncreate ----------
    @override
    protected void oncreate(bundle savedinstancestate) {
        super.oncreate(savedinstancestate);
        setcontentview(r.layout.activity_main);  // 布局见下文
 
        // 按钮触发两种更新
        button btnplayupdate    = findviewbyid(r.id.btnplayupdate);
        button btncustomupdate  = findviewbyid(r.id.btncustomupdate);
 
        btnplayupdate.setonclicklistener(new view.onclicklistener() {
            @override public void onclick(view v) {
                checkplayupdate();   // play 商店内更新
            }
        });
 
        btncustomupdate.setonclicklistener(new view.onclicklistener() {
            @override public void onclick(view v) {
                checkcustomupdate(); // 自建服务器更新
            }
        });
 
        // 初始化 downloadmanager
        downloadmanager = (downloadmanager) getsystemservice(download_service);
        // 注册下载完成广播
        registerreceiver(ondownloadcomplete, new intentfilter(downloadmanager.action_download_complete));
    }
 
    // ---------- 1. play in‑app updates 检查 ----------
    private void checkplayupdate() {
        // 创建 appupdatemanager
        com.google.android.play.core.appupdate.appupdatemanager appupdatemanager =
                appupdatemanagerfactory.create(this);
 
        // 异步获取更新信息
        task<appupdateinfo> appupdateinfotask = appupdatemanager.getappupdateinfo();
        appupdateinfotask.addonsuccesslistener(info -> {
            // 判断是否有更新且支持立即更新
            if (info.updateavailability() == updateavailability.update_available
                    && info.isupdatetypeallowed(appupdatetype.flexible)) {
                try {
                    // 发起灵活更新请求
                    appupdatemanager.startupdateflowforresult(
                            info,
                            appupdatetype.flexible,
                            this,
                            request_code_update);
                } catch (exception e) {
                    log.e(tag, "play 更新启动失败", e);
                }
            } else {
                toast.maketext(this, "无可用更新或不支持此更新类型", toast.length_short).show();
            }
        });
    }
 
    // ---------- 2. 自建服务器版本检测 ----------
    private void checkcustomupdate() {
        new thread(() -> {
            try {
                // 1) 请求服务器 json
                url url = new url("https://your.server.com/latest_version.json");
                httpurlconnection conn = (httpurlconnection) url.openconnection();
                conn.setconnecttimeout(5000);
                conn.setrequestmethod("get");
                inputstream in = conn.getinputstream();
                scanner sc = new scanner(in).usedelimiter("\\a");
                string json = sc.hasnext() ? sc.next() : "";
                jsonobject obj = new jsonobject(json);
                final int serverversioncode = obj.getint("versioncode");
                final string apkurl       = obj.getstring("apkurl");
                final string changelog   = obj.getstring("changelog");
 
                // 2) 获取本地版本号
                int localversioncode = getpackagemanager()
                        .getpackageinfo(getpackagename(), 0).versioncode;
 
                if (serverversioncode > localversioncode) {
                    // 有新版，回到主线程弹窗提示
                    runonuithread(() ->
                        showupdatedialog(apkurl, changelog)
                    );
                } else {
                    runonuithread(() ->
                        toast.maketext(this, "已是最新版本", toast.length_short).show()
                    );
                }
            } catch (exception e) {
                log.e(tag, "检查更新失败", e);
            }
        }).start();
    }
 
    // ---------- 3. 弹出更新对话框 ----------
    private void showupdatedialog(string apkurl, string changelog) {
        new alertdialog.builder(this)
            .settitle("发现新版本")
            .setmessage(changelog)
            .setcancelable(false)
            .setpositivebutton("立即更新", (dialog, which) -> {
                startdownload(apkurl);
            })
            .setnegativebutton("稍后再说", null)
            .show();
    }
 
    // ---------- 4. 启动系统 downloadmanager 下载 apk ----------
    private void startdownload(string apkurl) {
        downloadmanager.request request = new downloadmanager.request(uri.parse(apkurl));
        request.setallowednetworktypes(downloadmanager.request.network_wifi
                                      | downloadmanager.request.network_mobile);
        request.settitle("正在下载更新包");
        request.setdestinationinexternalpublicdir(environment.directory_downloads, "update.apk");
        // 开始下载
        downloadid = downloadmanager.enqueue(request);
    }
 
    // ---------- 5. 监听下载完成，触发安装 ----------
    private broadcastreceiver ondownloadcomplete = new broadcastreceiver() {
        @override public void onreceive(context context, intent intent) {
            long id = intent.getlongextra(downloadmanager.extra_download_id, -1);
            if (id != downloadid) return;
 
            // 下载完成，安装 apk
            file apkfile = new file(environment.getexternalstoragepublicdirectory(
                            environment.directory_downloads), "update.apk");
 
            // android 8.0+ 需要请求安装未知应用权限
            if (build.version.sdk_int >= build.version_codes.o) {
                boolean caninstall = getpackagemanager().canrequestpackageinstalls();
                if (!caninstall) {
                    // 请求“安装未知应用”权限
                    activitycompat.requestpermissions(mainactivity.this,
                        new string[]{manifest.permission.request_install_packages},
                        request_install_permission);
                    return;
                }
            }
            installapk(apkfile);
        }
    };
 
    // ---------- 6. 处理未知来源权限申请结果 ----------
    @override
    public void onrequestpermissionsresult(int requestcode,
                                           @nonnull string[] permissions,
                                           @nonnull int[] grantresults) {
        if (requestcode == request_install_permission) {
            if (grantresults.length>0 && grantresults[0]==packagemanager.permission_granted) {
                // 再次触发安装（假设 apk 仍在下载目录）
                file apkfile = new file(environment.getexternalstoragepublicdirectory(
                                environment.directory_downloads), "update.apk");
                installapk(apkfile);
            } else {
                toast.maketext(this, "安装权限被拒绝，无法自动更新", toast.length_long).show();
            }
        }
        super.onrequestpermissionsresult(requestcode, permissions, grantresults);
    }
 
    // ---------- 7. 安装 apk 辅助方法 ----------
    private void installapk(file apkfile) {
        uri apkuri = fileprovider.geturiforfile(this,
                getpackagename() + ".fileprovider", apkfile);
 
        intent intent = new intent(intent.action_view);
        intent.setdataandtype(apkuri, "application/vnd.android.package-archive");
        intent.addflags(intent.flag_grant_read_uri_permission);
        intent.addflags(intent.flag_activity_new_task);
        try {
            startactivity(intent);
        } catch (activitynotfoundexception e) {
            toast.maketext(this, "无法启动安装程序", toast.length_long).show();
        }
    }
 
    // ---------- 8. activity 销毁时注销 receiver ----------
    @override
    protected void ondestroy() {
        super.ondestroy();
        unregisterreceiver(ondownloadcomplete);
    }
}

<!-- ======================================
文件: androidmanifest.xml
注意：需要配置 fileprovider 与权限
====================================== -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.autoupdate">
 
    <!-- 安装未知来源权限（android 8.0+ 需动态申请） -->
    <uses-permission android:name="android.permission.request_install_packages"/>
    <uses-permission android:name="android.permission.internet"/>
    <uses-permission android:name="android.permission.write_external_storage"/>
 
    <application
        android:allowbackup="true"
        android:label="@string/app_name"
        android:theme="@style/theme.appcompat.light.noactionbar">
 
        <!-- fileprovider 声明 -->
        <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>
 
        <activity android:name=".mainactivity">
            <intent-filter>
                <action android:name="android.intent.action.main"/>
                <category android:name="android.intent.category.launcher"/>
            </intent-filter>
        </activity>
    </application>
</manifest>

<!-- ======================================
文件: res/xml/file_paths.xml
fileprovider 路径配置
====================================== -->
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path name="download" path="download/"/>
</paths>

<!-- ======================================
文件: res/layout/activity_main.xml
简单示例界面
====================================== -->
<linearlayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:gravity="center"
    android:layout_width="match_parent" android:layout_height="match_parent"
    android:padding="24dp">
 
    <button
        android:id="@+id/btnplayupdate"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="play in‑app 更新"/>
 
    <view android:layout_height="16dp" android:layout_width="match_parent"/>
 
    <button
        android:id="@+id/btncustomupdate"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="自建服务更新"/>
</linearlayout>

五、方法解读

checkplayupdate()
检查 google play 上的更新可用性，并以“灵活更新”方式启动下载和安装流程。
checkcustomupdate()
通过 httpurlconnection 请求服务器 json，解析最新 versioncode 与 apkurl，对比本地版本，决定是否弹窗。
showupdatedialog(...)
基于服务器返回的 changelog 构建 alertdialog，提供“立即更新”与“稍后再说”两种交互。
startdownload(string apkurl)
使用系统 downloadmanager 发起后台下载，保存至公开目录，支持断点续传和系统下载通知。
broadcastreceiver ondownloadcomplete
监听 downloadmanager.action_download_complete 广播，确认是本次下载后触发安装流程。
onrequestpermissionsresult(...)
处理 android 8.0+ “安装未知来源”权限授权结果，授权后继续调用 installapk()。
installapk(file apkfile)
通过 fileprovider 获取 apk 的 content uri，并以 intent.action_view 调用系统安装器。

六、项目总结

优势

play core in‑app 更新：官方支持，体验与 play 商店一致，无需手工管理下载逻辑。
自建方案：灵活可控，支持任意分发渠道，自定义 ui 与灰度策略。

注意与优化

权限与兼容
- android 7.0+ 必须使用 fileprovider。
- android 8.0+ 需动态申请 request_install_packages。
下载失败重试
- 可结合 workmanager 增加重试与网络断线重连逻辑。
安全性
- 建议对 apk 做签名校验（计算 sha256 与服务器比对），防止被篡改。
ui 体验
- 对“立即更新”与“后台更新”作更多状态提示。
- 可显示下载进度条、进度通知等。
灰度/强制升级
- 可在服务器 json 中添加策略字段，如 forceupdate，在对话框中禁止“稍后再说”。