从 WPF 到鸿蒙 PC:OpenRPA 移植实战——CoreWF、NativeAOT 与 Avalonia 的三重突围
从 WPF 到鸿蒙 PC:OpenRPA 移植实战——CoreWF、NativeAOT 与 Avalonia 的三重突围
欢迎加入开源鸿蒙 PC 社区:https://harmonypc.csdn.net/
欢迎在 PC 社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper
适配开源地址:https://atomgit.com/OpenHarmonyPCDeveloper/ohos_OpenRPA
本文记录 open-rpa/openrpa 1.4.57.13 从 Windows 桌面迁到鸿蒙 PC 的完整过程:为什么不能整包照搬,如何把 GAC 版 WWF 换成 CoreWF、WPF 换成 Avalonia、FlaUI 换成鸿蒙原生 shim,以及 NativeAOT 下三个"同一个报错、三种根因"的深水坑。所有结论都来自真机截图与可复现命令,仓库已全量开源。
关键词:鸿蒙 PC、OpenRPA、NativeAOT、CoreWF、Avalonia、OpenHarmony、工作流引擎、应用移植、XComponent、Git LFS

一、项目移植适配信息说明
| 项目 | 信息 |
|---|---|
| 适配对象 | OpenRPA 1.4.57.13(Windows RPA 工具:WPF 设计器 + GAC 版 WWF 引擎 + FlaUI.UIA3) |
| 技术路线 | 分层承载:CoreWF 6.0.0 执行引擎 + Avalonia 11 UI 编译为 NativeAOT 共享库,XComponent 驱动;引擎经 librpaohos.so C ABI shim 接系统 |
| 工程来源 | https://atomgit.com/OpenHarmonyPCDeveloper/ohos_OpenRPA(HAP 壳在 hap/) |
| 等级 | T0 可运行 / T1 可用(三条内置示例在真机执行到"完成");T2 边界:XAML 导入、可视化设计器、完整插件、跨应用自动化、硬件键鼠 |
| 三处关键替换 | GAC WWF → CoreWF(MIT);WPF → Avalonia 11 + JSON 子集持久化;FlaUI/SendInput → librpaohos.so(一期仅应用内,跨应用注入需 ACL 不申请) |
| 上游画像 | 全部 net46/net462、WPF(PresentationCore/COM)、GAC 版 System.Activities、约 40 个绑定 IE/SAP/Office 的插件 |
核心判断:OpenRPA 的资产是"工作流模型与执行语义",不是某个 Windows 窗口 API。保留模型与语义(CoreWF 对齐 WWF 原语),重写宿主相关三块(UI、自动化、持久化),比整包照搬或彻底重写都现实。

二、环境准备
2.1 DevEco 与设备
| 项 | 要求 |
|---|---|
| 设备 | 鸿蒙 PC 真机(2in1)或 2in1 模拟器 |
| IDE | DevEco Studio 6.x(含 OHOS NDK,cpp 壳与 CMake 交叉编译靠它) |
git clone https://atomgit.com/OpenHarmonyPCDeveloper/ohos_OpenRPA.git
用 DevEco 打开仓库里的 hap/ 目录:entry/src/main/ets/ 是 ArkTS 壳(全屏 XComponent(type: SURFACE, libraryname: "entry")),entry/src/main/cpp/ 是 libentry.so 源码(构造函数 dlopen 引擎库),entry/libs/<abi>/ 是随库入库的 libavalonia.so(约 65 MB/ABI,克隆后无需重编)。检查两点:
AppScope/app.json5的 bundleName(调试期占位com.example.hm_webview_demo)——同包名旧应用先hdc uninstall;versionCode低于已装版本会被hdc install -r拒绝(9568263 downgrade),本项目实测"覆盖安装不生效"就是这个原因;module.json5的deviceTypes含"2in1"。
2.2 签名与首装
Signing Configs 勾选自动签名后点 Run。启动后应看到 Avalonia 自绘的三栏工作台(左工作流列表 / 中步骤编辑 / 右运行日志)——是 native 窗口,不是 WebView。验证核心链路:点内置示例工作流 → 运行 → 右栏出现真实步骤输出,三条示例全部执行到"完成"才算 T1 达成。日志 hdc shell hilog | grep -i avalonia 可看 AOT 运行时启动输出。
2.3 重编引擎与 UI(可选)
改 C# 需要 .NET 9 SDK + CoreWF 6.0.0 / Avalonia 11 NuGet 包 + OpenHarmony.NET.Runtime + PublishAotCross + zig fakeclang(与 ImageGlass 同链路)。一键脚本:
.\scripts\build_all.ps1
# zig/fakeclang 进 PATH → dotnet publish 双 ABI → 拷 libavalonia.so → hvigor assembleHap
别丢三个 AOT 裁剪点:rd.xml 保留 System.Activities 的 Argument 族(漏了 MissingMethodException)、keep.xml 与反射标注、PublishAot=true + NativeLib=Shared。
三、适配教程
3.1 路线取舍
五条路线里:ArkTS 重写等于重做 RPA(活动模型/变量作用域/循环语义全要重写);Electron 承载叠两层运行时;Web+HTTP 多一层边界;Qt 交叉编译同样是换语言。最终选分层承载,代价是"替换 GAC WWF + 补 Avalonia 平台层 + 为 AOT 逐项处理反射与表达式约束",收益是工作流语义与 UI 结构都保住。
3.2 执行引擎:11 类步骤模型 + 模型到 Activity 树
自建 11 类步骤原语做 JSON 持久化,再写"模型 → CoreWF Activity 树"编译器——CoreWF 6 不含 Roslyn,不能运行时编 C# 表达式。深水区是同一个 format null 异常的三层根因,依次排掉:① 自造 RootActivity 包装非法(Activity 树根必须是 CoreWF 认可的类型);② CoreWF 变量可见性规则(Variable 要挂在正确作用域,DelegateInArgument 取值用 .Get(ctx));③ AOT 下表达式编译与反射裁剪(Lambda 的 OutArgument 不能作 Assign.To,必须改 Variable;Argument 族反射构造被裁掉靠 rd.xml 保底)。排错铁律:先在 Windows 宿主跑绿托管链路,再上设备——CoreWF 校验错误 message 可能为 null 会吞真错。
3.3 UI 与持久化
Avalonia 侧最隐蔽的坑是"静默全空的 DataContext"——绑定失败不报错,界面渲染正常但全是空值。修法:全改编译绑定 + 显式设 DataContext。持久化两处平台差异:反射式序列化在 AOT 下失效(改 JSON 源生成器,构建期生成序列化代码);OHOS 上 AppContext.BaseDirectory 只读(工作流文件写进沙箱 filesDir)。自动化层一期边界:C ABI shim 只覆盖应用内 accessibility 查询/点击/设文本,跨应用注入明确列为 TODO。
下方章节为移植适配过程中的详细讲解。

图 1:鸿蒙 PC 真机上的 OpenRPA 工作台。顶栏是操作按钮,左栏三条内置示例,中栏是当前工作流的步骤卡片,底部是"添加步骤"输入区。
四、执行引擎:把 GAC 版 WWF 换成 CoreWF
上游工作流靠 GAC 里的 WWF 跑,而 .NET 9 / OpenHarmony 没有 GAC。执行侧改为 CoreWF(UiPath.Workflow 6.0.0 / Runtime 6.0.3,MIT),并自研"模型 → Activity 树"编译器。

4.1 步骤模型:11 类原语
先定义平台无关的步骤模型,覆盖 OpenRPA 常用原语:
public enum StepKind
{
Log, // 输出日志(Text 支持 {@var} 插值)
Assign, // VarName = Value
If, While, ForEach,
Delay,
OhosGetElement, OhosClick, OhosSetText, // 鸿蒙自动化
ReadFile, WriteFile
}
public sealed class WorkflowModel
{
public string Id { get; set; } = Guid.NewGuid().ToString("N");
public string Name { get; set; } = "未命名工作流";
public Dictionary<string, string> Variables { get; set; } = new();
public List<Step> Steps { get; set; } = [];
}
刻意不引 Roslyn:表达式能力限定为 {@var} 插值 + 数值/序数比较。这既是 AOT 友好的选择,也让工作流语义足够简单,便于 JSON 落盘。
4.2 编译器:模型到 Activity 树
WorkflowCompiler.Compile 把模型编译成 CoreWF 的 Sequence / If / While / ForEach<string> 与自定义 CodeActivity 族:
public static Activity Compile(WorkflowModel wf, Action<string>? log = null)
{
var table = new VarTable();
foreach (var name in wf.CollectVariables())
table.Map[name] = new Variable<string>(name, wf.Variables.TryGetValue(name, out var v) ? v ?? "" : "");
var seq = new Sequence();
foreach (var v in table.Map.Values) seq.Variables.Add(v);
foreach (var a in CompileSteps(wf.Steps, table, log)) seq.Activities.Add(a);
return seq; // 直接返回根 Sequence,不要再包一层
}
执行器用 WorkflowInvoker.Invoke(activity, timeout),5 分钟超时兜底,日志经事件回调送到 UI 线程:
public event Action<string>? Log;
public RunResult Run(WorkflowModel wf, TimeSpan? timeout = null)
{
void Sink(string s) { result.Logs.Add(s); Log?.Invoke(s); }
try
{
var activity = WorkflowCompiler.Compile(wf, Sink);
WorkflowInvoker.Invoke(activity, timeout ?? TimeSpan.FromMinutes(5));
result.Ok = true;
}
catch (Exception ex)
{
// CoreWF 资源在 AOT 下可能缺失,ex.Message 会被 "format" null 掩盖,
// 故同时输出类型/堆栈/内层异常链
Sink($"[RUN] 失败: {ex.GetType().FullName}: {ex.Message}");
var cur = ex.InnerException;
while (cur is not null) { Sink($"[RUN] 内层: {cur.GetType().FullName}: {cur.Message}"); cur = cur.InnerException; }
result.Ok = false;
}
return result;
}
五、深水区:同一个 format null,三种根因
这是整篇移植里最费时的一章,也是最值得写下来的部分。真机连续三次报同一个错误:
[RUN] 失败: Value cannot be null. (Parameter 'format')
三次的根因完全不同。记录这段,是因为它揭示了一个通用规律:CoreWF 6.x 的错误串资源在 AOT 下缺失,会把真实校验错误吞掉,包装成看起来毫不相干的 ArgumentNullException。
5.1 第一层:自造的 RootActivity 包装非法
最初的编译器把 Sequence 包进自造的 RootActivity:
private sealed class RootActivity : Activity
{
public required Sequence Body { get; set; }
public RootActivity() => Implementation = () => Body;
}
Windows 宿主一跑就露馅:
'RootActivity': The activity 'Sequence' cannot be referenced by activity 'RootActivity'
because the latter is not in another activity's implementation.
修法很朴素——直接返回根 Sequence,变量与子活动都声明在它上面,不额外包装。
5.2 第二层:CoreWF 的变量可见性规则
去掉包装后又撞上:
Activity '6: LambdaValue<String>' cannot access this variable because it is declared
at the scope of activity '1: Sequence'. An activity can only access its own implementation variables.
我们做了 7 组最小 Trial 实验,得到三条硬规则:
- ❌ 公共子活动在
Execute里直接Variable.Get(ctx)访问父 scope 变量——被拒; - ❌ 把动态 lambda 绑到
CodeActivity<T>.Result(Out 位置要 L-value)——报Invalid L-value expression; - ✅ 唯一合法通道是
InArgument/OutArgument绑定:直接new InArgument<string>(variable),或 lambda 表达式中语法级出现Variable.Get(ctx)。
我们最初的写法 ctx => t.Resolve(s.Text, ctx) 把变量藏在运行期字典里,CoreWF 的表达式校验看不见,一 Get 就被拒。
5.3 第三层:AOT 下表达式编译与反射裁剪
第二次修复用 Expression 树动态构造表达式,Windows 全绿,真机仍然报 format null。这次堆栈给了线索:
System.ArgumentNullException: Value cannot be null. (Parameter 'format')
at System.Activities.WorkflowApplication.Invoke(...)
两层原因叠加:
- NativeAOT 下
LambdaExpression.Compile/LambdaValue走表达式解释器不可靠; - 更隐蔽的是——CoreWF 默认
CacheMetadata靠反射扫描活动类的 publicInArgument/OutArgument属性,AOT 把自定义活动的反射元数据裁掉后,扫描不到 Argument,校验失败,错误串资源又缺失,才包装成formatnull。
最终方案是"零表达式 + 精确保留"两手:
(1)把插值从表达式挪进活动内部。 新增 TemplateActivities.cs,变量经固定数量 InArgument 流入:
public abstract class TemplateActivityBase<TResult> : CodeActivity<TResult>
{
public required string Template { get; set; }
public InArgument<string> V0 { get; set; } = "";
public InArgument<string> V1 { get; set; } = "";
// ... V2..V7 逐个 public 声明(集合属性会报 "argument of type String cannot be used")
protected string Resolve(ActivityContext ctx)
{
var args = new[] { V0, V1, V2, V3, V4, V5, V6, V7 };
var vals = new string[args.Length];
for (int i = 0; i < args.Length; i++) vals[i] = args[i].Get(ctx) ?? "";
return Expressions.InterpolateOrdered(Template, vals);
}
}
public sealed class TemplateTextActivity : TemplateActivityBase<string>
{
protected override string Execute(CodeActivityContext ctx) => Resolve(ctx);
}
编译期把 {@var} 里的变量绑到 V0..V7,Execute 内只做纯插值。全工程不再有 lambda 表达式 / Expression.Compile——连 ForEach.Values 也走 TemplateItemsActivity,循环变量用 new InArgument<string>(delegateInArgument) 直接绑定(不要包自定义活动,WF 会起默认名 Argument 导致 DelegateArgument 'Argument' does not exist)。
(2)rd.xml 精确保留反射元数据:
<Assembly Name="Rpa.Core" Dynamic="Required All" />
<Assembly Name="System.Activities">
<Type Name="System.Activities.Argument" Dynamic="Required All"><Method Name=".ctor" /></Type>
<Type Name="System.Activities.InArgument`1" Dynamic="Required All" />
<Type Name="System.Activities.OutArgument`1" Dynamic="Required All" />
<Type Name="System.Activities.CodeActivity" Dynamic="Required All" />
<Type Name="System.Activities.CodeActivity`1" Dynamic="Required All" />
<Type Name="System.Activities.Variable`1" Dynamic="Required All" />
<Type Name="System.Activities.Validation.ValidationError" Dynamic="Required All" />
</Assembly>
一个反例:图省事写
<Assembly Name="System.Activities" Dynamic="Required All" />整包保留,ilc 编译耗时爆炸——实测 CPU 时间超过 30 分钟仍未完成。必须精确列举类型。
(3)诊断增强。 在 Invoke 前显式跑一次 ActivityValidationServices.Validate 并输出 [VALIDATE] 行;失败时输出异常类型、内层异常链与堆栈。这样即使 CoreWF 再吞错误,也能从运行日志里看到活动名定位。
5.4 排错铁律
CoreWF 的资源缺失会把真实校验错误伪装成各种
null/format异常。遇到不明运行错误,先在 Windows 宿主跑同一工作流。 我们保留src/Rpa.Smoke冒烟工程就是为此——它能在几十秒内给出真实错误串,而不是在真机上猜。
六、UI 层:静默全空的 DataContext
界面层从 WPF 换成 Avalonia 11.2.8,复用同工作区 ImageGlass 已验证的 OpenHarmony.Avalonia 平台层。三栏工作台用编译绑定,看起来 straightforward,却踩了一个极具迷惑性的坑。
鸿蒙走的是 ISingleViewApplicationLifetime 分支:
public override void OnFrameworkInitializationCompleted()
{
if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
desktop.MainWindow = new MainWindow();
else if (ApplicationLifetime is ISingleViewApplicationLifetime single)
single.MainView = new MainView();
}
最初 MainView 自己从不设 DataContext,而工程开了 AvaloniaUseCompiledBindingsByDefault=true。编译绑定在 DataContext 为 null 时不报错、不抛异常,只是静默取不到值——表现就是"界面是新的,但三栏全空,只剩硬编码文字"。
判据很明确:连 Status 的初始字符串和 StepKinds(枚举名列表)都不显示,就是 DataContext 没设。 修法是在 MainView 构造函数里挂上 ViewModel:
public MainView()
{
InitializeComponent();
// OHOS 走 ISingleViewApplicationLifetime,不会经过 App.MainWindow,
// 必须在这里挂 DataContext,否则所有编译绑定静默显示为空。
DataContext = new WorkbenchViewModel();
}
这个坑的教训是:AOT / 编译绑定体系里,“没有报错"不等于"没有问题”。静默失败比抛异常更难定位,因为它没有堆栈。
七、持久化:JSON 源生成与可写目录
上游用 System.Xaml 序列化 WWF XAML;CoreWF 6 不含 System.Xaml,我们改用 System.Text.Json 的 JSON 子集,并做两处 AOT 适配。
7.1 反射式序列化在 AOT 下失效
new JsonStringEnumConverter() + JsonSerializer.Serialize<T>(obj, options) 在 NativeAOT 下会抛 NotSupportedException,导致"保存"永久失败。改为源生成:
[JsonSourceGenerationOptions(WriteIndented = true, UseStringEnumConverter = true)]
[JsonSerializable(typeof(WorkflowModel))]
internal sealed partial class WorkflowJsonContext : JsonSerializerContext;
public static string Serialize(WorkflowModel wf) =>
JsonSerializer.Serialize(wf, WorkflowJsonContext.Default.WorkflowModel);
public static WorkflowModel Deserialize(string json) =>
JsonSerializer.Deserialize(json, WorkflowJsonContext.Default.WorkflowModel)
?? throw new InvalidDataException("工作流 JSON 无效");
改完后 IL2026 / IL3050 警告随之消失。
7.2 OHOS 上 AppContext.BaseDirectory 只读
WorkflowStore.WorkDir() 按以下顺序探测可写目录:
var env = Environment.GetEnvironmentVariable("RPA_WORKDIR");
if (!string.IsNullOrWhiteSpace(env) && TryEnsure(env, out var dir0)) return dir0;
// 再依次尝试 LocalApplicationData → 临时目录 → BaseDirectory
7.3 自动化层:一期边界
hap/entry/src/main/cpp/rpaohos.cpp 导出 C ABI 供 P/Invoke:
int rpaohos_query(const char* selector, long* handle);
int rpaohos_click(long handle);
int rpaohos_set_text(long handle, const char* text);
int rpaohos_click_xy(double x, double y); // 恒返回 2 = UNSUPPORTED
返回码:0=OK、1=NOT_FOUND、2=UNSUPPORTED、<0=错误。一期边界如实声明:鸿蒙不向普通三方 HAP 暴露跨应用无障碍注入(需 ACL),query/click/set_text 当前作用于本 HAP 自身节点树的桩路径;跨应用调用返回 UNSUPPORTED,不把桩伪装成完整能力。
八、构建、签名与真机验收
8.1 一键构建
仓库已自包含(含三项不可从源码重建的二进制依赖),clone 后只需 .NET SDK 9.0.321、zig 0.13.0、DevEco Studio:
git lfs install
git clone https://atomgit.com/OpenHarmonyPCDeveloper/ohos_OpenRPA.git
cd ohos_OpenRPA
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\build_all.ps1
脚本分三段:managed AOT 双 ABI → 自动同步 libavalonia.so 到 hap/entry/libs/ → hvigor 打包 HAP。同步是防呆设计:Rpa.Entry.csproj 的 SyncToHapLibs target 在 AfterTargets=Publish 按 RID 自动拷贝,build_all.ps1 再比对字节数;这是因为早期 hap/ 壳从 ImageGlass 模板 robocopy 时把 IG 的旧库(64.3 MB)也带了进来,出现"标题是 OpenRPA、画面是看图器"的诡异现象。
大文件通过 Git LFS 存储(635 个对象、约 1.4 GB)。AtomGit 的 100 MiB hook 会拒绝直接提交的大文件;直接下载 ZIP 拿不到 LFS 对象。
8.2 安装:覆盖安装不生效的坑
实测改完 so 后重新 Build HAP(versionCode 9900100 未变),普通覆盖安装不生效,应用继续跑旧库。必须强制重装并重启进程:
hdc app install -r entry-default-signed.hap
hdc shell aa force-stop com.example.hm_webview_demo
hdc shell aa start -b com.example.hm_webview_demo -a EntryAbility
hdc shell "hilog -x | grep -i -e csharp -e RpaOhos -e AvaloniaRootComponentSurface"
另一个反直觉点:Avalonia UI 全部自绘在 XComponent surface 上,uitest dumpLayout 只能看到壳的窗口标题,不能用来判断界面新旧。别被它误导。
8.3 真机结果:三条示例全部跑通

图 2:批量点名工作流。日志面板依次出现 点名:alpha / beta / gamma、[FS] Write rollcall.txt、[FS] Read rollcall.txt (10 chars)、回读结果:最后点到:gamma,最后 [RUN] 批量点名 完成。这验证了变量插值、循环变量写回、文件读写三条链路。

图 3:欢迎流水线。日志里 你好,鸿蒙 PC!OpenRPA 移植版已就绪。 与 If 分支命中:n=3 表明 Log、Assign、If 分支均按语义执行。

图 4:自身应用自动化演示。[OHOS] GetElement OK => #1、SetText OK #1、Click OK #1 说明 librpaohos.so 的 C ABI shim 已被 NativeAOT 侧正确调用;跨应用注入仍按一期边界返回 UNSUPPORTED。
九、能力分级与已知边界
把真机结果按 T0/T1/T2 口径汇总:
| 阶段 | 状态 | 依据 |
|---|---|---|
| T0 可运行 | 已达成 | HAP 构建签名成功;真机安装启动;XComponent 出帧;三栏工作台完整渲染;三条示例工作流可见 |
| T1 可用 | 已达成 | 真机截图确认三条示例全部执行到"完成",日志面板出现变量插值、If 分支、ForEach 循环、文件写读与 OHOS 自动化 shim 的真实输出 |
| T2 好用 | 部分达成 | 三栏视觉、JSON 持久化、AOT 双 ABI、日志可观测到位;上游 XAML 导入、可视化设计器、跨应用自动化、硬件键鼠、多窗口、插件生态未适配 |
T2 未达标项不是"忘了做",而是有明确原因的产品取舍:
- 上游
.xaml工作流不直接兼容(CoreWF 6 不含System.Xaml),需要子集导入器; - 跨应用自动化受系统 ACL 约束,一期只在本 HAP 自身应用内生效;
- 硬件键盘、鼠标滚轮、弹层、多窗口依赖平台层输入与窗口子系统,属于平台层工程缺口,不是应用层多写代码能解决;
- 约 40 个 Windows 专属插件一期剔除。
包体方面,双 ABI HAP 约 119 MB(NativeAOT 本体约 91 MB/ABI),支持改单 ABI 减重。
十、QA:移植过程中最常被问到的问题
Q1:为什么不直接把 OpenRPA 的 .NET Framework 代码编译到鸿蒙?
A:上游全部是 net46/net462,还带 WPF、GAC WWF 和大量 COM 引用。.NET 9 / OpenHarmony 没有 GAC,也没有 WPF。 NativeAOT 路线要求把宿主相关部分换掉;如果强行整包照搬,光是 COM 引用就无法解析。我们选择保留工作流模型语义,替换 UI、引擎来源与自动化层。
Q2:CoreWF 和上游的 WWF 语义完全一致吗?
A:活动模型和核心原语(Sequence / If / While / ForEach / Assign)对齐,但表达式能力做了子集化:不引 Roslyn,只支持 {@var} 插值与简单比较。上游用 System.Xaml 序列化的工作流不能直接读,需要导入器转换。这是明确的兼容边界。
Q3:AOT 下 CoreWF 报 format null,怎么快速定位?
A:三层排查:① 先在 Windows 宿主跑 src/Rpa.Smoke,拿到真实错误串;② 检查 rd.xml 是否保留了 Rpa.Core 与 CoreWF 关键类型;③ 检查代码里是否残留 Expression.Compile / LambdaValue。我们的经验是——真机上看到的 format null 从来不是根因。
Q4:rd.xml 为什么不能整包保留 System.Activities?
A:可以,但代价不可接受。实测整包 Dynamic="Required All" 会让 ilc 编译 CPU 时间超过 30 分钟仍未完成。精确列举 Argument、InArgument<T>、OutArgument<T>、Variable<T>、CodeActivity、CodeActivity<T>、ValidationError 等关键类型即可。
Q5:为什么界面出来了但三栏全空?
A:大概率是 MainView 没挂 DataContext。鸿蒙走 ISingleViewApplicationLifetime,不会经过 App.MainWindow;编译绑定在 DataContext 为 null 时静默失败,不报错。判据:连初始状态字符串和枚举列表都不显示。
Q6:为什么重新 Build 后运行还是旧界面?
A:两个独立坑:一是 libavalonia.so 没同步(现在由 SyncToHapLibs + 字节数校验防呆);二是同 versionCode 的普通覆盖安装不生效,必须 hdc app install -r 强制重装并 aa force-stop。另外别用 uitest dumpLayout 判断界面新旧——Avalonia 是自绘的。
Q7:保存工作流时报"目录不可写"怎么办?
A:OHOS 上 AppContext.BaseDirectory 是只读的应用库目录。WorkflowStore.WorkDir() 会按 RPA_WORKDIR 环境变量 → LocalApplicationData → 临时目录 → BaseDirectory 顺序探测可写路径;正常无需干预,特殊环境可设 RPA_WORKDIR。
Q8:跨应用自动化能做到吗?
A:当前版本不做。鸿蒙不向普通三方 HAP 暴露跨应用无障碍注入能力(需要 ACL)。rpaohos_click_xy 恒返回 UNSUPPORTED,一期只在本 HAP 自身应用内生效。任何声称"普通 HAP 能跨应用注入"的方案都应先核对系统权限边界。
Q9:别人 clone 仓库后能直接构建吗?
A:可以。仓库自包含三项二进制依赖(平台层、ilcompiler 运行时包、交叉工具链),所有工程引用都改成仓内相对路径。但需要本机有 .NET SDK 9.0.321、zig 0.13.0 与 DevEco Studio,并且必须先 git lfs install 再 clone——直接下载 ZIP 拿不到 LFS 对象。
Q10:这个移植能算"完成"吗?
A:按 T0/T1 口径已经完成并有真机证据;T2 是产品级对齐,涉及平台层输入、窗口子系统与上游生态兼容,属于后续计划。我们用分级而非"完成/未完成"的二元口径来描述,就是为了不让"能跑"掩盖边界。
十一、结语与资料
回看这次移植,真正耗时的不是"把代码搬过去",而是三件事:选对承载路线(保留语义、替换宿主)、尊重 AOT 的约束(零表达式、精确保留反射元数据)、诚实标注边界(XAML 子集、自动化一期范围)。那句在排错中反复应验的话值得留给后来者:
“错误一字未变 = 根因未触及。”
同一个 format null 背后藏了三种完全不同的根因;只有逐层剥开,才能从"毫无变化"走到四张真机截图里的全部通过。
更多推荐


所有评论(0)