Maui Blazor Android应用如何程序化安装下载的APK文件

一、配置AndroidManifest.xml #

首先修改Platforms/Android/AndroidManifest.xml文件，添加必要权限和FileProvider组件：

1. 添加权限声明

<!-- Android 8.0+ 需声明安装未知来源应用权限 -->
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
<!-- 网络下载权限（已配置可忽略） -->
<uses-permission android:name="android.permission.INTERNET" />

2. 添加FileProvider配置（让系统安装器访问应用私有目录）
   在<application>标签内插入：

<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>

3. 创建文件路径配置
   在Platforms/Android/Resources下新建xml目录，创建file_paths.xml文件：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 映射应用私有AppDataDirectory目录 -->
    <files-path name="app_data" path="." />
</paths>

二、检查并请求安装权限 #

Android 8.0+需要用户授权安装未知来源应用，添加以下权限校验代码：

using Android.Content;
using Android.OS;
using AndroidX.Core.Content;

// 检查是否拥有安装权限
private bool HasInstallPermission()
{
    if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
    {
        return Android.App.Application.Context.PackageManager.CanRequestPackageInstalls();
    }
    // Android 8.0以下默认允许
    return true;
}

// 跳转系统设置请求安装权限
private async Task RequestInstallPermission()
{
    if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
    {
        var intent = new Intent(Android.Provider.Settings.ActionManageUnknownAppSources, 
                                Android.Net.Uri.Parse($"package:{Android.App.Application.Context.PackageName}"));
        await MainThread.InvokeOnMainThreadAsync(() =>
        {
            Android.App.Application.Context.StartActivity(intent.AddFlags(ActivityFlags.NewTask));
        });
    }
}

三、启动APK安装流程 #

不能用System.Diagnostics.Process.Start，需通过Android系统Intent调用安装界面，配合FileProvider共享私有目录的APK文件：

using Android.Content;
using Android.Net;
using Microsoft.Maui.Storage;

public async Task InstallApk(string apkFileName)
{
    // 先校验权限
    if (!HasInstallPermission())
    {
        await RequestInstallPermission();
        // 可提示用户授权后重试
        return;
    }

    // 获取APK文件路径
    var apkFullPath = Path.Combine(FileSystem.AppDataDirectory, apkFileName);
    var apkFile = new Java.IO.File(apkFullPath);

    if (!apkFile.Exists())
    {
        // 处理文件不存在逻辑
        return;
    }

    // 通过FileProvider生成可被安装器访问的URI
    var apkUri = FileProvider.GetUriForFile(Android.App.Application.Context, 
                                           $"{Android.App.Application.Context.PackageName}.fileprovider", 
                                           apkFile);

    // 创建安装Intent
    var installIntent = new Intent(Intent.ActionInstallPackage);
    installIntent.SetData(apkUri);
    // 授予安装器临时文件读取权限
    installIntent.AddFlags(ActivityFlags.GrantReadUriPermission);
    installIntent.AddFlags(ActivityFlags.NewTask);

    // 启动系统安装界面
    await MainThread.InvokeOnMainThreadAsync(() =>
    {
        Android.App.Application.Context.StartActivity(installIntent);
    });
}

四、Blazor组件中调用安装方法 #

在Blazor页面中通过条件编译调用Android专属代码：

@page "/update"
@inject IJSRuntime JSRuntime

<button @onclick="TriggerInstall">安装最新版本</button>

@code {
    private async Task TriggerInstall()
    {
#if ANDROID
        // 替换为你的APK文件名
        await InstallApk("your_app_v2.apk");
#else
        await JSRuntime.InvokeVoidAsync("alert", "仅支持Android平台");
#endif
    }

    // 将前面的HasInstallPermission、RequestInstallPermission、InstallApk方法复制到此处
}

注意事项 #

• 确保下载的APK文件完整，可通过校验MD5/SHA值避免损坏文件导致安装失败
• 必须在真实Android设备上测试，部分模拟器权限逻辑存在异常
• Android 11+如需后台静默安装，可改用PackageInstallerAPI（前台触发安装用上述Intent方式即可）

内容的提问来源于stack exchange，提问作者Holistiker