Flutter 3.47 鸿蒙三方库适配实战：从 0 到 1 处理 installed_apps

读取设备上已安装的应用列表，常用于设备管理、应用推荐、跳转类场景。installed_apps 在 Android 上走 PackageManager，在 iOS 上走有限的公开接口。把它带到鸿蒙时，包管理数据的读取权限模型是核心问题。

本文以 installed_apps 2.2.1 为例，记录我如何保留原有 Dart API、补齐 Flutter OH 插件入口、在鸿蒙端接入真实系统能力，并在 HarmonyOS API 26 真机上完成构建、安装、启动和按钮调用验证。

适配仓库： oh-flutter/installed_apps

适配分支： feat/ohos_installed_apps_2.2.1

适配 TAG： 2.2.1-ohos.2

一、先看最终效果

在这里插入图片描述

图 1：HarmonyOS API 26 真机启动 Demo。页面显示 installed_apps 2.2.1。

在这里插入图片描述

图 2：点击“按包名查询应用信息”后返回 1 条记录，应用名称与版本号来自 bundleManager.getBundleInfo。

验证点实测结果证据
Flutter OH 3.47 工程构建通过entry-default-signed.hap
安装、启动（真机）通过图 1
按包名查询返回真实的应用名称与版本号图 2
isAppInstalled返回 true图 3
启动本应用返回 true，Ability 正常拉起AMS 日志

在这里插入图片描述

图 3：点击“检查应用安装状态”后返回 isAppInstalled = true。

二、这个库原来是怎么工作的

installed_apps 的公开接口是静态方法集合：

Dart InstalledApps
  -> MethodChannel('installed_apps')
  -> Android PackageManager / iOS info.plist
  -> 应用列表、应用信息、安装状态

方法包括 getInstalledApps、getAppInfo、isAppInstalled、isSystemApp、startApp、uninstallApp、openSettings、toast。

三、实际环境

Flutter 鸿蒙环境搭建不在本文重复展开，直接参考 Flutter OH 环境搭建指南。

组件版本
Flutter OH3.47.4-ohos-1.0.4
Dart3.13.3
DevEco Studio26.0.0 Release
HarmonyOS SDKAPI 26
测试设备华为畅享 90 Pro Max，HarmonyOS 7.0.0.105（API 26）
目标库installed_apps 2.2.1
flutter --version
hdc list targets

四、确认上游版本并同步到 AtomGit

上游包地址是 https://github.com/sharmadhiraj/installed_apps，版本 2.2.1 使用 Apache-2.0 License。适配前我在 AtomGit 目标组织中搜索了同名库，没有找到可以直接使用的 OHOS 实现。

仓库适配提交为 42a9fab，分支与 TAG 2.2.1-ohos.2 均指向该提交。

git clone https://atomgit.com/oh-flutter/installed_apps.git
cd installed_apps
git switch feat/ohos_installed_apps_2.2.1
git log --oneline -5

五、创建适配分支并检查工程结构

git switch -c feat/ohos_installed_apps_2.2.1

关键目录如下：

installed_apps/
├── lib/                                        # 原有 Dart API 和 MethodChannel
├── ohos/
│   ├── index.ets                               # OHOS 插件导出入口
│   └── src/main/ets/components/plugin/
│       └── InstalledAppsPlugin.ets                           # 通道实现
├── example/lib/main.dart                        # 真机验证 Demo
├── example/ohos/                                # Flutter OH 宿主工程
├── pubspec.yaml                                # 声明 ohos 平台
└── README.OpenHarmony_CN.md                    # 鸿蒙适配说明

pubspec.yaml 中的关键声明是：

flutter:
  plugin:
    platforms:
      ohos:
        pluginClass: InstalledAppsPlugin

pluginClass 必须和 ohos/index.ets 导出的类名一致，否则 Dart 端能编译，运行时却不会注册插件。

六、适配过程：注册通道并对齐语义

// 按包名查询：bundleManager.getBundleInfo
const info = await bundleManager.getBundleInfo(packageName, QUERY_FLAGS);
const app = info.appInfo;
const result = {
  'name': app.label,            // label 资源已用 getStringSync 解析
  'package_name': info.name,
  'version_name': info.versionName,
  'version_code': info.versionCode,
  'installed_timestamp': info.installTime,
  'is_system_app': app.systemApp,
  'is_launchable_app': hasMainElement(info),
};
方法OpenHarmony 实现
getInstalledApps(packageNames: [...])bundleManager.getBundleInfo() 逐个查询
getInstalledApps()（无参）返回空列表（全量枚举需系统权限）
isAppInstalled / getAppInfo / isSystemApp同上
startAppstartAbility 显式 Want
toastpromptAction.showToast

七、构建配置与签名

示例工程的目标 SDK 对齐到 26，与 @ohos/flutter_ohos 的最低要求一致：

{
  "name": "default",
  "compatibleSdkVersion": "26.0.0",
  "targetSdkVersion": "26.0.0",
  "runtimeOS": "HarmonyOS"
}

Demo 的 AppScope/app.json5 统一成 com.example.flutter_oh_demo，与 DevEco 调试签名对应。证书、p12、p7b 和密码没有提交到仓库，读者应在自己的 DevEco Studio 中生成调试签名。

八、通过 AtomGit 引入适配版

在另一个 Flutter OH 应用中使用时，建议锁定 TAG：

dependencies:
  installed_apps:
    git:
      url: https://atomgit.com/oh-flutter/installed_apps.git
      ref: 2.2.1-ohos.2

flutter pub get

然后在 pubspec.lock 检查 source: git、AtomGit 地址和 resolved-ref，确认没有解析到 pub.dev 的同名版本。

九、构建、安装和真机验证

cd example
flutter pub get
flutter analyze
flutter build hap --debug
hdc install -r build/ohos/hap/entry-default-signed.hap
hdc shell aa start -a EntryAbility -b com.example.flutter_oh_demo

构建输出为 ✓ Built build/ohos/hap/entry-default-signed.hap.，随后 hdc 报告安装成功并启动 Ability。真机上按本文的截图顺序逐一点击按钮完成验证。

十、适配结果和当前边界

这里的能力边界是鸿蒙的隐私设计，有明确的系统日志证据：

GetBundleInfo forbidden by permission: ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

普通应用连其他应用的基础信息都读不到（该权限是 system_basic 级）。可以读到的是本应用自身的信息，以及用户在 packageNames 里显式指定的、已授权的包。

因此本实现以“按包名查询”为主路径：调用方提供包名，插件返回该系统应用的真实名称、版本、安装时间和是否系统应用。全量枚举与卸载他人应用属于系统级权限（system_basic / enterprise），普通应用通过按包名查询即可覆盖设备管理、应用推荐和跳转等常见场景。

十一、FAQ

Q1：按包名查询返回哪些字段？

  • 现象： 返回应用名称、包名、版本名、版本号、安装时间、是否系统应用和是否可启动。
  • 解决方法： 传入 packageNames 做定向查询，一次可查询多个包。
  • 验证结果： 真机查到该应用的名称与版本号。

Q2：isAppInstalled 如何判断安装状态？

  • 现象： 查询完整 flags 在部分设备上会被权限拦截，本实现改为降级重试，完整 flags 不可用时回退到基础 flags。
  • 解决方法： 升级到 2.2.1-ohos.2。
  • 验证结果： 真机返回 true。

Q3：启动本应用是怎么实现的？

  • 现象： 获取任意应用的 launch Want 需要系统权限，启动本应用不需要。
  • 解决方法： 使用显式 Want 拉起本应用 Ability。
  • 验证结果： startApp 返回 true，AMS 日志可见。

十二、总结

installed_apps 2.2.1 已接入鸿蒙的包管理：用 bundleManager 实现按包名查询应用信息、检查安装状态、启动应用与系统 Toast。按包名查询与启动本应用已在真机验证通过；全量枚举与卸载他人应用属于系统级权限，文中已说明其边界。

十三、参考资料和仓库地址

欢迎加入CPF-Flutter 鸿蒙社区：https://atomgit.com/CPF-Flutter

# flutter # harmonyos # 华为 # 架构 # 运维
Logo
人工智能6S服务平台

作为“人工智能6S店”的官方数字引擎，为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐

cover

从 Python 光学库到鸿蒙 PC 原生应用：ohos_Optiland 的移植适配实战

avatar 人工智能6S服务平台
cover

把 Qucs-S 搬上鸿蒙 PC：「电路芯绘」移植实战开发实录

avatar 人工智能6S服务平台

纯血鸿蒙本地应用实测：六十四卦知识库「易经学」，离线可用数据不出手机

最近在纯血鸿蒙上试了一款叫「易经学」的本地应用，把它当作《易经》的随身知识库来用。选它的出发点很简单：六十四卦这类传统文化内容，能不离开手机就别离开。下面按我自己的使用路径，实测几个核心模块，仅作个人体验分享。

avatar 人工智能6S服务平台