MAUI Android应用永久存储字符串（Guid）的问题排查与解决

一、先排查 SecureStorage 失效的常见问题 #

• 确认模拟器API版本：MAUI的SecureStorage在Android上依赖EncryptedSharedPreferences，要求Android API 23（Android 6.0）及以上，若模拟器版本低于此，直接换用更高版本模拟器。
• 检查异步调用是否正确：SecureStorage的所有方法都是异步的，必须用await调用，不能用.Wait()或.Result强行同步，否则会导致操作未执行完成就结束。

正确的SecureStorage使用示例：

// 存储Guid
async Task SaveAppGuid(string guid)
{
    await SecureStorage.SetAsync("PersistentAppGuid", guid);
}

// 获取Guid
async Task<string> LoadAppGuid()
{
    return await SecureStorage.GetAsync("PersistentAppGuid");
}

调用示例（必须在异步方法内）：

protected override async void OnAppearing()
{
    base.OnAppearing();
    var newGuid = Guid.NewGuid().ToString();
    await SaveAppGuid(newGuid);
    var savedGuid = await LoadAppGuid();
    // 验证savedGuid是否和newGuid一致
}

二、如果 SecureStorage 仍无法工作，改用原生 Android SharedPreferences #

SharedPreferences是Android原生的持久化存储方案，数据会永久保留（直到应用卸载或设备格式化），完全满足你的需求。在MAUI中可以通过依赖服务实现：

步骤1：定义跨平台接口 #

public interface IPersistentStorage
{
    void StoreString(string key, string value);
    string RetrieveString(string key, string defaultValue = null);
}

步骤2：Android平台实现 #

在Android项目中创建实现类：

[assembly: Dependency(typeof(AndroidPersistentStorage))]
namespace YourAppNamespace.Platforms.Android
{
    public class AndroidPersistentStorage : IPersistentStorage
    {
        private readonly ISharedPreferences _storage;

        public AndroidPersistentStorage()
        {
            // 创建私有存储文件，仅当前应用可访问
            _storage = Android.App.Application.Context.GetSharedPreferences("AppPermanentStorage", FileCreationMode.Private);
        }

        public void StoreString(string key, string value)
        {
            using var editor = _storage.Edit();
            editor.PutString(key, value);
            editor.Apply(); // 异步提交，性能更好；若需同步用Commit()
        }

        public string RetrieveString(string key, string defaultValue = null)
        {
            return _storage.GetString(key, defaultValue);
        }
    }
}

步骤3：共享代码中调用 #

var storage = DependencyService.Get<IPersistentStorage>();
// 存储Guid
storage.StoreString("AppGuid", Guid.NewGuid().ToString());
// 获取Guid
var savedGuid = storage.RetrieveString("AppGuid");

三、备选方案：文件系统存储 #

如果需要存储更长的内容，也可以将字符串写入应用的私人目录文件，该目录下的文件不会被系统自动清理：

// 存储到文件
async Task SaveGuidToFile(string guid)
{
    var filePath = Path.Combine(FileSystem.AppDataDirectory, "app_guid.txt");
    await File.WriteAllTextAsync(filePath, guid);
}

// 从文件读取
async Task<string> LoadGuidFromFile()
{
    var filePath = Path.Combine(FileSystem.AppDataDirectory, "app_guid.txt");
    return File.Exists(filePath) ? await File.ReadAllTextAsync(filePath) : null;
}

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