龍魂鸿蒙技能 · longhun-harmonyos SKILL.md v1.0

龍魂鸿蒙技能 · longhun-harmonyos SKILL.md v1.0 龍魂鸿蒙技能 · longhun-harmonyos SKILL.md v1.0DNA:#龍芯⚡️丙午·丙申·癸丑·申时·需-LONGHUN-HARMONYOS-SKILL-v1.0注册日期: 2026-07-08技能编号: SKILL-031安全级别: S4 (SM4国密端侧加密·数据不出境)知识来源: ai6s.net 63K开发者社区 鸿蒙API交付标准模板 论文Behavioral Cryptography技能概述面向鸿蒙(HarmonyOS)生态的全栈开发技能从ArkTS/ArkUI基础到原生应用交付覆盖调试、适配、性能优化、安全加密全链路。触发词鸿蒙 / HarmonyOS / ArkTS / ArkUI / 华为开发 / 鸿蒙适配 / 鸿蒙调试 / hdc / DevEco / 鸿蒙部署 / 鸿蒙原生人格路由场景人格鸿蒙代码编写/调试P02 龍芯 P15 乔前辈鸿蒙安全审计P77 黑天使军团鸿蒙API交付P02 龍芯 P05 上帝之眼鸿蒙架构设计P02 龍芯 P06 数学大师跨平台迁移(Android→鸿蒙)P15 乔前辈 P02 龍芯一、ArkTS ArkUI 核心知识1.1 基础概念ArkTS TypeScript超集 静态类型检查 声明式UI 状态管理 (大脑) ArkUI 声明式UI框架 (画笔) 一句话: ArkTS写逻辑ArkUI画界面1.2 装饰器全集装饰器类别作用使用场景State组件内状态变量变→UI刷新表单输入、开关状态Prop父子单向父传子·子不可逆列表项数据展示Link父子双向共享引用·双向同步弹窗编辑、抽屉ObjectLink嵌套对象深层对象追踪复杂数据模型Observed嵌套对象标记可观察类配合ObjectLinkStorageLink全局状态AppStorage双向主题/语言切换StorageProp全局单向AppStorage单向全局配置读取Component组件标记声明自定义组件所有自定义组件BuilderUI片段可复用UI模板重复UI结构Entry页面入口标记页面级组件每个页面Local(V2)组件内部V2版替代State新项目推荐Param(V2)参数传递V2版替代Prop新项目推荐Event(V2)事件回调V2版回调新项目推荐ObservedV2类观察V2版替代Observed新项目推荐Trace属性追踪V2版细粒度追踪新项目推荐1.3 四种定位详解方式脱离文档流参考系多端适配典型场景.offset({x,y})❌ 原位置保留自身原位置⭐⭐⭐微调红点、气泡.position({x,y})✅ 不占位父容器左上角⭐绝对覆盖RelativeContainer❌锚点组件⭐⭐⭐⭐复杂表单、仪表盘StackAlignment❌九宫格方位⭐⭐⭐封面角标、弹窗1.4 let/const/State 区别letconstState可变✅❌✅UI响应❌❌✅用途临时计算不可变常量界面数据本质ES6语法ES6语法ArkTS框架1.5 布局最佳实践// ✅ 推荐: 自适应布局Column(){Text(标题).fontSize(20)Row(){Text(左).layoutWeight(1)Text(右).layoutWeight(1)}.width(100%)}.padding(16)// ✅ 推荐: 断点响应Componentstruct ResponsiveGrid{Statecolumns:number2aboutToAppear(){// 根据屏幕宽度动态设置列数this.columnsdisplay.getDefaultDisplaySync().width600?4:2}build(){Grid(){ForEach(data,(item){GridItem(){ItemCard({item})}})}.columnsTemplate(repeat(${this.columns}, 1fr))}}// ❌ 避免: 写死尺寸Text(内容).width(375).height(667)// 其他设备会出问题二、HARMONY-COMPAT 评估模型2.1 公式COMPAT C×0.10 O×0.20 M×0.10 P×0.25 A×0.20 T×0.15 C: 兼容层运行率 (崩溃率/启动率) O: API兼容网 (调用异常率) M: 运行稳定性 (30天崩溃频次) P: 性能测量 (帧率/延迟/内存) A: 适配层级 (0兼容层, 3中度, 5原生专属) T: 任务衰减 (k值·指数衰减模型)2.2 适配层级定义LevelSDK调用率专属内容COMPAT区间010%无3.0-5.0330-50%无鸿蒙专属6.0-7.5590%鸿蒙专属板块8.5-10.02.3 衰减模型Y(t) Y_stable (Y_peak - Y_stable) × e^(-kt) k0.08: 原生适配(30天仅衰减16%) k0.50: 兼容层(衰减53%)2.4 Python实现importmathdefharmony_compat_score(C,O,M,P,A,T):HARMONY-COMPAT 六维度评估returnC*0.10O*0.20M*0.10P*0.25A*0.20T*0.15defdecay_value(Y_stable,Y_peak,k,t):指数衰减模型returnY_stable(Y_peak-Y_stable)*math.exp(-k*t)# 实测示例apps{果冻试玩(原生):harmony_compat_score(10,10,9,9.5,5,9.5),# 9.30淘宝(兼容):harmony_compat_score(9,8,9,7.5,3,9.5),# 6.85抖音(兼容):harmony_compat_score(7,6,7,5.0,2,4.0),# 4.60}三、Android → ArkUI 迁移速查3.1 生命周期映射// Android Activity → HarmonyOS UIAbility// ─────────────────────────────────────────────// onCreate() → onCreate()// onStart() → onWindowStageCreate()// onResume() → onForeground()// onPause() → onBackground()// onDestroy() → onDestroy()// Android Fragment → HarmonyOS Component// onCreateView() → build()// onResume() → aboutToAppear()// onPause() → aboutToDisappear()3.2 布局速查LinearLayout(vertical) → Column LinearLayout(horizontal) → Row FrameLayout → Stack RelativeLayout → RelativeContainer ConstraintLayout → RelativeContainer / Flex RecyclerView → List LazyForEach ViewPager → Swiper TabLayout → Tabs TabContent ScrollView → Scroll GridView → Grid GridItem3.3 尺寸单位dp → vp (1:1 密度无关) sp → fp (字体缩放) match_parent → .width(100%) wrap_content → .height(auto) 或不设置3.4 Compose → ArkUI V2 速查Jetpack ComposeArkUI V2ComposableComponentV2remember { }LocalmutableStateOfLocalModifier.xxx().xxx() 链式调用LaunchedEffectaboutToAppear asyncViewModel StateFlowObservedV2 TraceNavHostNavigation NavPathStack3.5 资源引用R.string.xxx → $r(app.string.xxx) R.drawable.xxx → $r(app.media.xxx) R.color.xxx → $r(app.color.xxx) R.dimen.xxx → $r(app.float.xxx) R.raw.xxx → $rawfile(xxx)3.6 数据存储SharedPreferences → ohos.data.preferences (异步) Room/SQLite → ohos.data.relationalStore ContentProvider → DataShareExtension四、鸿蒙API交付标准72项检查现有7项v1.0·已焊死·铁律A-013✅ 权限声明 (module.json5 requestPermissions)✅ 动态服务器地址 (build-profile.json5)✅ 统一错误处理 (try-catch 用户提示)✅ 设备能力检查 (canIUse API)✅ 多设备资源分层 (resources/phone, tablet, tv)✅ UI动态适配 (vp/fp 断点)✅ EntryAbility生命周期新增2项v1.1建议 HARMONY-COMPAT适配层级验证目标层级 ≥ Level 3COMPAT总分 ≥ 6.0/10原生API调用率 ≥ 30% ArkUI声明式范式检查禁止WebView直套状态管理使用装饰器布局使用弹性布局资源引用使用$r()五、现有鸿蒙项目清单项目路径API适配层级状态通心译翻译integrations/harmonyos/tongxinyi/5.0(12)Level 5✅ 7项全绿CNSH编辑器cnsh-editor/platforms/harmonyos/API 11Level 3✅ 475行女娲五彩石字体longhun-font/examples/harmonyos/API 11Level 3✅ 示例剪贴板原子化服务integrations/clipboard/5.0Level 3✅ v2.0跨平台互通skills/longhun-cross-platform/-Level 3✅ SM4ECDH六、调试 工具链hdc 命令速查hdc list targets# 列出设备hdc shell# 进入shellhdcfilesendlocalremote# 推送文件hdcfilerecv remotelocal# 拉取文件hdcinstallxxx.hap# 安装应用hdc uninstall com.xxx# 卸载hdc shell aa start-aEntryAbility-bcom.xxx# 启动版本匹配铁律hdc客户端版本 hdc服务端版本 设备端hdc版本 三者不一致 → 连接失败七、技能执行规则交付前必过72项检查(铁律A-013)代码必须使用 $r() 资源引用— 禁止硬编码字符串/颜色/尺寸布局必须弹性— 禁止写死px使用vp/fp layoutWeight安全级别S4— SM4国密加密数据不出境DNA追溯— 每个鸿蒙文件必须有v∞格式DNA签章API版本标注— 文件头注明兼容的HarmonyOS API版本联动感知— 鸿蒙项目变更必须同步更新此技能文件签名Skill ID: SKILL-031DNA:#龍芯⚡️丙午·丙申·癸丑·申时·需-LONGHUN-HARMONYOS-SKILL-v1.0知识融合: ai6s.net社区 Behavioral Cryptography论文 鸿蒙API标准模板安全级别: S4三色审计: 通过