ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

如何在 Harmony 应用中集成 Lynx markdown XElement 并初始化原生组件

如何在 Harmony 应用中集成 Lynx markdown XElement 并初始化原生组件 如何在 Harmony 应用中集成 Lynx markdown XElement 并初始化原生组件【免费下载链接】lynxEmpower the Web community and invite more to build across platforms.项目地址: https://gitcode.com/GitHub_Trending/lynx10/lynx在 Harmony 平台的 Lynx 应用里使用 Markdown 渲染需要引入lynx/xelement_markdown包并完成原生组件注册。这个包通过注册一个原生 C XElement 来提供markdown标签注册时会从liblynx_xelement_markdown.so解析实现布局和渲染都留在 C UI/原生侧。完成本文操作后你的 Harmony 应用可以在创建 Lynx 视图前把 markdown 的 UI 创建器与 ShadowNode 创建器注册进 Lynx 原生注册表使markdown标签可用。安装 lynx/xelement_markdown 包在 Harmony 工程目录下执行ohpm install lynx/xelement_markdown然后在工程依赖文件oh-package.json5中加入依赖。README 给出的示例版本为0.0.1-alpha.1{ dependencies: { lynx/xelement_markdown: 0.0.1-alpha.1, } }包自身声明的依赖见 oh-package.json5其中包括lynx/lynx、liblynx_xelement_markdown.so以file:./src/main/cpp/types/liblynx_xelement_markdown本地引用方式提供、lynx/serval_markdown0.1.3 和lynx/lynxtextra0.1.6。在创建 Lynx 视图前调用 initialize()在你的 ArkTS 代码中导入XElementMarkdown并在可能使用 markdown 的 Lynx 视图创建之前调用一次initialize()import { XElementMarkdown } from lynx/xelement_markdown; XElementMarkdown.initialize();initialize()的作用是加载包内的原生模块并注册 markdown 创建器。查看 Index.ets 可以看到内部实现类里有一个initialized标志位initialize()先检查该标志未初始化时调用原生模块的markdown.initMarkdown()然后置为已初始化因此重复调用不会重复注册。时序要求只有一个initialize()必须发生在创建使用 markdown 的 Lynx 视图之前。初始化在原生侧完成了什么initMarkdown()对应 entry.cc 中的InitMarkdown函数。它执行的动作是把markdown这个标签写入LynxContext::GetCAPINodeInfoMap()注册项包含三个字段CreateMarkdownUIUI 创建器实际调用UIMarkdown::Make(context, sign, tag)CreateMarkdownShadowNodeShadowNode 创建器实际调用MarkdownShadowNode::Make(sign, tag)LayoutNodeType::CUSTOM布局节点类型。同一个文件还导出了两个 C 符号UILynxMarkdownCreateFunc和LynxUIMarkdownShadowNodeCreateFunc供原生注册表解析使用。按 agents/harmony_xelement.md 中的约定核心lynx/lynx包不直接依赖lynx/serval_markdown或lynx/lynxtextra而是由原生注册表通过dlopen/dlsym从lynx/xelement_markdown的原生库中解析 markdown 创建器。UI 侧的UIMarkdown继承自UIBase见 ui_markdown.h内部持有serval::markdown::NativeServalMarkdownView完成渲染实现了属性更新、布局更新、方法调用和销毁等生命周期接口。原生依赖链与约束README 中说明了这条集成路径的依赖关系核对原生依赖时可以对照Harmony arm64 与 x86_64 构建中实现打包在liblynx_xelement_markdown.so它链接包提供的libserval_markdown.so和 lynxtextra 原生库lynx/serval_markdown需要暴露原生 XElement 使用的 C 视图层符号包括NativeServalMarkdownView和MarkdownViewShadow 布局通过MarkdownView::Measure()测量而不是依赖 serval 内部的 measurer 类这条路径不使用内部的liblynx_markdown.so包也不构建或加载它。另外两条集成约束同样来自 agents/harmony_xelement.md在二次开发时需要注意markdown从原生 XElement 注册表注册markdown是lynx/下唯一公开的标签不要为内部 markdown 标签添加兼容别名不要把markdown实现成对lynx/serval_markdown的 ArkTSUIBase封装——serval markdown 只提供解析、布局和绘制核心Lynx XElement 集成必须保持原生实现。如何确认初始化生效entry.cc 在关键节点输出了日志可用于核对初始化与创建流程是否被执行以下为源码中定义的日志内容不是必须逐字出现的固定输出模块加载时输出Register XElement markdown native module和XElement markdown native module InitinitMarkdown被调用时输出XElement markdown initMarkdown calledLynx 视图创建过程中真正走到创建器时分别输出XElement markdown UI creator called, sign: ... , tag: ...和XElement markdown shadow creator called, sign: ... , tag: ...。也就是说应用启动阶段看到 init 相关日志说明initialize()已执行UI/shadow creator 日志只在 Lynx 视图实际创建markdown节点时出现可以作为标签被注册表正确解析的信号。当前版本的覆盖范围与边界README 的 Platform gaps 一节明确界定了首个原生桥接的版本边界使用时应以此为预期已覆盖注册、基础 content/style/config 属性、原生测量、原生绘制、选区切换以及少量 UI 方法尚未覆盖markdown 图片的 Lynx 资源加载、事件/曝光转发、内联/替换 Lynx 子视图、完整的接口方法覆盖。如果后续版本补齐了这些能力以上限制会随之变化集成时以当前安装版本对应的 README 为准。【免费下载链接】lynxEmpower the Web community and invite more to build across platforms.项目地址: https://gitcode.com/GitHub_Trending/lynx10/lynx创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表