MAUI + Masa Blazor 開發帶自動更新功能的安卓App
自動更新主要下面4個步驟
- 獲取最新版本號
- 提示用户發現更新，等待用户確認更新
- 下載最新的apk包
- 安裝apk包
下面從創建MAUI項目開始
1、創建Maui Blazor Server應用
2、安裝Masa.Blazor，並添加引用
dotnet add package Masa.Blazor
在 wwwroot/index.html 中引入資源文件
<!-- masa blazor css style -->
<link href="http://masa-blazor-docs-dev.lonsid.cn/_content/Masa.Blazor/css/masa-blazor.min.css" rel="stylesheet">
<link href="http://cdn.masastack.com/npm/@mdi/[email protected]/css/materialdesignicons.min.css" rel="stylesheet">
<link href="http://cdn.masastack.com/npm/materialicons/materialicons.css" rel="stylesheet">
<link href="http://cdn.masastack.com/npm/fontawesome/v5.0.13/css/all.css" rel="stylesheet">
<link rel="stylesheet" href="http://cdn.masastack.com/stack/fonts/roboto/font-roboto.css">
<!--js(should lay the end of file)-->
<script src="_content/BlazorComponent/js/blazor-component.js"></script>
在 _Imports.razor 添加，對Masa Blazor 的全局引用
@using Masa.Blazor
@using BlazorComponent
在MauiProgram.cs中注入服務
builder.Services.AddMasaBlazor();
修改Shared / MainLayout.razor文件，設置MApp為根元素
@inherits LayoutComponentBase
<div class="page">
<div class="sidebar">
<NavMenu />
</div>
<main>
<div class="top-row px-4">
<a href="http://docs.microsoft.com/aspnet/" target="_blank">About</a>
</div>
<article class="content px-4">
<MApp>@Body</MApp>
</article>
</main>
</div>
項目屬性中修改-已共享MAUI-中的應用程序ID及版本 
3、開始編寫代碼
創建Service目錄，添加IUpgradeService.cs接口
namespace MauiMasaBlazorDemo.Service
{
public interface IUpgradeService
{
/// <summary>
/// 檢查更新
/// </summary>
/// <param name="url">
/// 檢查URL
/// </param>
/// <returns></returns>
Task<Dictionary<string, string>> CheckUpdatesAsync(string url);
/// <summary>
/// 下載安裝文件
/// </summary>
/// <param name="url">
/// 下載URL
/// </param>
/// <param name="action">
/// 進度條處理方法
/// </param>
/// <returns></returns>
Task DownloadFileAsync(string url, Action<long, long> action);
/// <summary>
/// 安裝APK的方法
/// </summary>
void InstallNewVersion();
}
}
這裏需要使用到 FileProvider，在Android 7之後出於安全考慮不再支持content://URL 或file:///URL這種文件訪問方式，可參考FileProvider | Android Developers ，我們先添加一下對應配置
在Platforms/Android/Resources下面新建xml文件夾，並添加provider_paths.xml文件
<?xml version="1.0" encoding="utf-8"?>
<resources>
<paths>
<root-path name="root" path="" />
<files-path name="files" path="" />
<cache-path name="cache" path="" />
<external-path name="camera_photos" path="" />
<external-files-path name="external_file_path" path="" />
<external-cache-path name="external_cache_path" path="" />
</paths>
</resources>
修改Platforms / Android下面的AndroidManifest.xml文件，在application下添加provider，再添加一個安卓安裝的權限REQUEST_INSTALL_PACKAGES
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<application android:allowBackup="true" android:icon="@mipmap/appicon" android:roundIcon="@mipmap/appicon_round" android:supportsRtl="true">
<provider
android:name="androidx.core.content.FileProvider"
android:authorities="com.masa.mauidemo.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/provider_paths" />
</provider>
</application>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
</manifest>
在Platforms / Android下添加UpgradeService.cs
獲取版本號可以通過MAUI提供的 VersionTracking，該類還有很多版本相關的功能，可參考
Version tracking - .NET MAUI | Microsoft Docs
Intent 是一種運行時綁定（run-time binding）機制，Android的三個基本組件 Activity，Service和Broadcast Receiver 都是通過Intent機制激活的，有興趣可參考 Intent | Android Developers
using Android.Content;
using Android.OS;
using MauiMasaBlazorDemo.Service;
namespace MauiMasaBlazorDemo
{
public class UpgradeService : IUpgradeService
{
readonly HttpClient _client;
public UpgradeService()
{
_client = new HttpClient();
}
public async Task<Dictionary<string, string>> CheckUpdatesAsync(string url)
{
var result = new Dictionary<string, string>();
// 獲取當前版本號
var currentVersion = VersionTracking.CurrentVersion;
var latestVersion = await _client.GetStringAsync(url);
result.Add("CurrentVersion", currentVersion);
result.Add("LatestVersion", latestVersion);
return result;
}
public void InstallNewVersion()
{
var file = $"{FileSystem.AppDataDirectory}/{"com.masa.mauidemo.apk"}";
var apkFile = new Java.IO.File(file);
var intent = new Intent(Intent.ActionView);
// 判斷Android版本
if (Build.VERSION.SdkInt >= BuildVersionCodes.N)
{
//給臨時讀取權限
intent.SetFlags(ActivityFlags.GrantReadUriPermission);
var uri = FileProvider.GetUriForFile(Android.App.Application.Context, "com.masa.mauidemo.fileprovider", apkFile);
// 設置顯式 MIME 數據類型
intent.SetDataAndType(uri, "application/vnd.android.package-archive");
}
else
{
intent.SetDataAndType(Android.Net.Uri.FromFile(new Java.IO.File(file)), "application/vnd.android.package-archive");
}
//指定以新任務的方式啟動Activity
intent.AddFlags(ActivityFlags.NewTask);
//激活一個新的Activity
Android.App.Application.Context.StartActivity(intent);
}
public async Task DownloadFileAsync(string url, Action<long, long> action)
{
var req = new HttpRequestMessage(new HttpMethod("GET"), url);
var response = _client.SendAsync(req, HttpCompletionOption.ResponseHeadersRead).Result;
var allLength = response.Content.Headers.ContentLength;
var stream = await response.Content.ReadAsStreamAsync();
var file = $"{FileSystem.AppDataDirectory}/{"com.masa.mauidemo.apk"}";
await using var fileStream = new FileStream(file, FileMode.Create);
await using (stream)
{
var buffer = new byte[10240];
var readLength = 0;
int length;
while ((length = await stream.ReadAsync(buffer, 0, buffer.Length)) != 0)
{
readLength += length;
action(readLength, allLength!.Value);
// 寫入到文件
fileStream.Write(buffer, 0, length);
}
}
}
}
}
其中com.masa.mauidemo.apk 為安裝文件apk的文件名稱。
在MauiProgram.cs中添加註入，這裏使用條件編譯，在平台為Android時使用
#if ANDROID
builder.Services.AddSingleton<IUpgradeService, UpgradeService>();
#endif
在Pages中新增Index.razor.cs
using BlazorComponent;
using Masa.Blazor;
using MauiMasaBlazorDemo.Service;
using Microsoft.AspNetCore.Components;
namespace MauiMasaBlazorDemo.Pages
{
public partial class Index
{
[Inject]
public IPopupService PopupService { get; set; }
[Inject]
private IUpgradeService UpgradeService { get; set; }
private int Ps { get; set; }
private long TotalBytesToReceive { get; set; }
private long BytesReceived { get; set; }
private long _unReadMsgCnt = 0;
private bool _updateDialog;
/// <summary>
/// 獲取最新版本
/// </summary>
/// <returns></returns>
public async Task GetVersionNew()
{
var result = await UpgradeService.CheckUpdatesAsync($"http://你的域名/update.txt?t={DateTime.Now.ToUniversalTime().Ticks}");
if (result["CurrentVersion"] != result["LatestVersion"])
{
var confirm = await PopupService.ConfirmAsync($"檢測到新版本，是否升級", "版本號為：" + result["LatestVersion"]);
if (confirm)
{
_updateDialog = true;
await UpgradeService.DownloadFileAsync("http://你的域名/com.masa.mauidemo.apk", DownloadProgressChanged);
UpgradeService.InstallNewVersion();
}
}
else
{
await PopupService.AlertAsync($"當前版本已經是最新版,版本號為：" + result["LatestVersion"], AlertTypes.Success);
}
}
private void DownloadProgressChanged(long readLength, long allLength)
{
InvokeAsync(() =>
{
var c = (int)(readLength * 100 / allLength);
if (c > 0 && c % 5 == 0) //刷新進度為每5%更新一次，過快的刷新會導致頁面顯示數值與實際不一致
{
Ps = c; //下載完成百分比
BytesReceived = readLength / 1024; //當前已經下載的Kb
TotalBytesToReceive = allLength / 1024; //文件總大小Kb
StateHasChanged();
}
});
}
}
}
修改Index.razor 添加按鈕、確認對話框、進度條組件。Masa blazor是國內不多可以完美支持MAUI的blazor組件
@page "/"
<MButton OnClick="GetVersionNew">
<MLabel>檢查更新</MLabel>
<MIcon>mdi-home</MIcon>
</MButton>
<div class="text-center">
<MDialog @bind-Value="_updateDialog"
Width="500">
<ChildContent>
<MCard>
<MCardTitle Class="text-h5 grey lighten-2">
正在更新請稍後...
</MCardTitle>
<MCardText>
@BytesReceived KB/@TotalBytesToReceive KB
<MProgressLinear Value="@Ps" Striped Height="15" Color="light-blue">
<strong>@Ps %</strong>
</MProgressLinear>
</MCardText>
</MCard>
</ChildContent>
</MDialog>
</div>
4、項目打包、簽名、發佈
項目屬性中修改Android包格式為Apk 
命令行生成一個安卓簽名證書（部分手機沒有證書籤名不允許安裝），過程中會提示輸入證書密碼，密碼要記住，其他隨意填
keytool -genkey -v -keystore masa-maui-demo.keystore -alias key -keyalg RSA -keysize 2048 -validity 10000
項目屬性，切換到-Android-包簽名，勾選“APK簽名”密鑰存儲選擇剛剛生成的keystore文件，輸入密鑰“存儲密碼”和“別名密碼”，這兩個密碼都填剛剛生成證書的密碼，別名不設置的情況下，也需要輸入別名密碼，否則會在發佈時提示“打包進程失敗”。 
解決方案配置中切換到Release,生成一下項目，然後右鍵項目名稱-選擇發佈，發佈0.0.1版本，發佈過程會自動對apk進行簽名 
點右下角的打開文件夾，找到簽名之後的apk文件，上傳到阿里雲OSS，同時再上傳一個名為update.txt的文本文件，內容為“0.0.1”，這兩個文件的地址就是GetVersionNew方法中的兩個地址。 
注意：
1、如果使用的下載apk的協議不是https，那麼需要在AndroidManifest.xml文件 application 節點中添加 android:usesCleartextTraffic="true"
2、如果是使用iis的話需要在MIEI中添加 MIME類型：
application/vnd.android.package-archive，否則apk文件無法下載
這樣我們的自動升級功能就開發完畢了，如果程序新加了功能我們我們需要做：
1、修改項目的版本號，例如修改“應用程序顯示版本”為0.0.2，應用程序版本：2
2、重新發布apk
3、上傳到阿里雲OSS，修改update.txt文件為0.0.2
下面為真機演示效果
「其他文章」
- Blazor在IoT領域的前端實踐 @.NET開發者日
- MASA MAUI Plugin （十）iOS消息推送（原生APNS方式）
- MASA MAUI Plugin （九）Android相冊多選照片（使用Android Jetpack套件庫）
- MASA MAUI Plugin （八）Android相冊多選照片（Intent 方式）
- MASA Stack 1.0 發佈會講稿——生態篇
- MASA Stack 1.0 發佈會講稿——實踐篇
- MASA Stack 1.0 發佈會講稿——產品篇
- MASA Stack 1.0 發佈會講稿——趨勢篇
- MASA MAUI Plugin （七）應用通知角標（小紅點）Android iOS
- .NET現代化應用開發 - CQRS&類目管理代碼剖析
- MASA MAUI Plugin 安卓藍牙低功耗（二）藍牙通訊
- MASA MAUI Plugin 安卓藍牙低功耗（一）藍牙掃描
- MASA MAUI Plugin 安卓藍牙低功耗（二）藍牙通訊
- MASA MAUI Plugin 安卓藍牙低功耗（一）藍牙掃描
- MASA Framework的分佈式鎖設計
- MAUI Masa Blazor 開發界面跟隨系統主題切換的App
- MAUI Masa Blazor 開發界面跟隨系統主題切換的App
- MAUI Masa Blazor 開發帶自動更新功能的安卓App
- 開篇-開啟全新的.NET現代應用開發體驗
- 怎麼樣的框架對於開發者是友好的？