@ohos-cpf/3rdloop 0.0.1 → 0.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +245 -425
- package/bin/3rdloop.mjs +46 -46
- package/lib/cli.js +781 -740
- package/lib/config-cmd.js +452 -0
- package/lib/config.js +318 -317
- package/lib/doctor.js +113 -113
- package/lib/exit-codes.js +30 -30
- package/lib/opencode.js +155 -155
- package/lib/orch.js +426 -426
- package/lib/queries.js +263 -263
- package/lib/step.js +325 -325
- package/lib/ui.js +222 -222
- package/lib/update.js +280 -0
- package/lib/workflow.js +308 -290
- package/lib/workflows.js +131 -131
- package/package.json +50 -50
- package/vendor/Server/Agent/SkillSelector/README.md +343 -343
- package/vendor/Server/Agent/SkillSelector/core/Agent.js +207 -207
- package/vendor/Server/Agent/SkillSelector/index.js +14 -14
- package/vendor/Server/Agent/SkillSelector/llm/llmClient.js +313 -313
- package/vendor/Server/Agent/SkillSelector/llm/prompts.js +161 -161
- package/vendor/Server/Agent/SkillSelector/llm/reactSteps.js +144 -144
- package/vendor/Server/Agent/SkillSelector/matcher/fuzzyMatcher.js +433 -433
- package/vendor/Server/Agent/SkillSelector/scanner/skillScanner.js +382 -382
- package/vendor/Server/Agent/SkillSelector/utils/actionWords.js +59 -59
- package/vendor/Server/Brain/AnalysisStrategies.js +422 -422
- package/vendor/Server/Brain/Brain.js +686 -686
- package/vendor/Server/Brain/DecompositionStrategies.js +621 -621
- package/vendor/Server/Brain/PlanPersistence.js +196 -196
- package/vendor/Server/Brain/SkillExecutor.js +251 -251
- package/vendor/Server/Brain/index.js +11 -11
- package/vendor/Server/CLI/cli.js +275 -243
- package/vendor/Server/CLI/deveco-code/index.js +71 -0
- package/vendor/Server/CLI/deveco-code.js +5 -0
- package/vendor/Server/CLI/opencode/index.js +817 -804
- package/vendor/Server/CLI/opencode.js +5 -5
- package/vendor/Server/DbUse/MessageArchive.js +61 -61
- package/vendor/Server/DbUse/StorageManager.js +107 -107
- package/vendor/Server/DbUse/adapters/BaseAdapter.js +94 -94
- package/vendor/Server/DbUse/adapters/FileAdapter.js +138 -138
- package/vendor/Server/DbUse/adapters/JsonAdapter.js +138 -138
- package/vendor/Server/DbUse/adapters/JsonlAdapter.js +114 -114
- package/vendor/Server/DbUse/adapters/SqliteAdapter.js +157 -157
- package/vendor/Server/DbUse/index.js +160 -160
- package/vendor/Server/DbUse/stores/SessionStore.js +279 -279
- package/vendor/Server/DbUse/stores/TaskExecutionStore.js +133 -133
- package/vendor/Server/DbUse/stores/TaskRegistryStore.js +262 -262
- package/vendor/Server/DbUse/stores/TaskStepStore.js +279 -279
- package/vendor/Server/FlexRunner/FlexRunner.js +1759 -1759
- package/vendor/Server/FlexRunner/index.js +12 -12
- package/vendor/Server/Knowledge/KnowledgeImporter.js +523 -523
- package/vendor/Server/Knowledge/KnowledgeManager.js +341 -341
- package/vendor/Server/Knowledge/index.js +33 -33
- package/vendor/Server/LoopEngine/LoopEngine.js +1133 -1133
- package/vendor/Server/LoopEngine/index.js +11 -11
- package/vendor/Server/Orchestrator/Orchestrator.js +0 -3
- package/vendor/Server/Orchestrator/StepNode.js +312 -312
- package/vendor/Server/Orchestrator/index.js +13 -13
- package/vendor/Server/Routes/controllers/BrainController.js +241 -241
- package/vendor/Server/Routes/controllers/FlexRunnerController.js +1125 -1125
- package/vendor/Server/Routes/controllers/HealthController.js +44 -44
- package/vendor/Server/Routes/controllers/KnowledgeImportController.js +355 -355
- package/vendor/Server/Routes/controllers/LoopEngineController.js +788 -788
- package/vendor/Server/Routes/controllers/StatsController.js +57 -57
- package/vendor/Server/Routes/controllers/StreamController.js +67 -67
- package/vendor/Server/Routes/library/logger.js +179 -179
- package/vendor/Server/Routes/library/zipArchive.js +172 -172
- package/vendor/Server/Routes/router/Router.js +204 -204
- package/vendor/Server/Routes/routes/brain.js +47 -47
- package/vendor/Server/Routes/routes/flexrunner.js +72 -72
- package/vendor/Server/Routes/routes/health.js +28 -28
- package/vendor/Server/Routes/routes/index.js +57 -57
- package/vendor/Server/Routes/routes/knowledge.js +55 -55
- package/vendor/Server/Routes/routes/loopengine.js +58 -58
- package/vendor/Server/Routes/routes/orchestrator.js +61 -61
- package/vendor/Server/Routes/routes/registry.js +97 -97
- package/vendor/Server/Routes/routes/stats.js +23 -23
- package/vendor/Server/Routes/routes/stream.js +30 -30
- package/vendor/Server/Routes/server.js +203 -202
- package/vendor/Server/Routes/sse/SseHub.js +308 -308
- package/vendor/Server/Skills/acceptance-check/SKILL.md +191 -174
- package/vendor/Server/Skills/acceptance-check/references/PHASE1_ARTIFACT_COLLECTION.md +52 -52
- package/vendor/Server/Skills/acceptance-check/references/PHASE2_CRITERIA_EVALUATION.md +77 -77
- package/vendor/Server/Skills/acceptance-check/references/PHASE2_EVIDENCE_VERIFICATION.md +70 -0
- package/vendor/Server/Skills/arkts-code-check/SKILL.md +320 -313
- package/vendor/Server/Skills/arkts-code-check/references/CODE_CHECK_GUIDE.md +210 -159
- package/vendor/Server/Skills/arkts-code-check/references/FILE_TYPE_GUIDE.md +28 -28
- package/vendor/Server/Skills/arkts-code-check/references/PHASE1_INFO_COLLECTION.md +233 -222
- package/vendor/Server/Skills/arkts-code-check/references/REPORT_TEMPLATE.md +219 -219
- package/vendor/Server/Skills/arkts-library-compile-validate/SKILL.md +328 -328
- package/vendor/Server/Skills/arkts-library-compile-validate/scripts/build.ps1 +93 -93
- package/vendor/Server/Skills/arkts-library-compile-validate/scripts/code-linter.cjs +432 -432
- package/vendor/Server/Skills/arkts-library-compile-validate/scripts/migrate.cjs +851 -851
- package/vendor/Server/Skills/arkts-library-compile-validate/scripts/ohpm-switch.cjs +788 -788
- package/vendor/Server/Skills/arkts-library-demo-code/SKILL.md +291 -291
- package/vendor/Server/Skills/arkts-library-demo-code/references/API_SIGNATURE_CHECKS.md +68 -68
- package/vendor/Server/Skills/arkts-library-demo-code/references/BUILD_VALIDATION.md +184 -184
- package/vendor/Server/Skills/arkts-library-demo-code/references/CODE_STANDARDS.md +337 -337
- package/vendor/Server/Skills/arkts-library-demo-code/references/EXAMPLES.md +400 -400
- package/vendor/Server/Skills/arkts-library-demo-code/references/SYSTEM_API_LOOKUP.md +98 -98
- package/vendor/Server/Skills/arkts-library-demo-code/references/TEMPLATE.md +544 -544
- package/vendor/Server/Skills/arkts-library-demo-code/scripts/build.ps1 +93 -93
- package/vendor/Server/Skills/arkts-library-demo-code/scripts/code-linter.cjs +432 -432
- package/vendor/Server/Skills/arkts-library-demo-code/scripts/migrate.cjs +851 -851
- package/vendor/Server/Skills/arkts-library-demo-code/scripts/ohpm-switch.cjs +788 -788
- package/vendor/Server/Skills/arkts-library-demo-coverage/SKILL.md +174 -174
- package/vendor/Server/Skills/arkts-library-demo-scenario/SKILL.md +321 -321
- package/vendor/Server/Skills/arkts-library-demo-scenario/references/EXAMPLES.md +100 -100
- package/vendor/Server/Skills/arkts-library-demo-scenario/references/TEMPLATE.md +185 -185
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/SKILL.md +233 -233
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/assets/REPORT_TEMPLATE.md +102 -102
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/CHECK_DIMENSIONS.md +89 -89
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/COMPLIANCE_CHECKLIST.md +62 -62
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/KB_QUERY_GUIDE.md +107 -107
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/MCP_TOOL_DISCOVERY.md +124 -124
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/REPORT_TEMPLATE.md +90 -90
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/references/SCORING_FORMULA.md +57 -57
- package/vendor/Server/Skills/arkts-library-documentation-quality-check/scripts/validate-skill.cjs +259 -259
- package/vendor/Server/Skills/arkts-library-interface-spec/SKILL.md +97 -97
- package/vendor/Server/Skills/arkts-library-memory-leak-check/SKILL.md +391 -391
- package/vendor/Server/Skills/arkts-library-source-clone/SKILL.md +113 -113
- package/vendor/Server/Skills/arkts-library-stability-check/SKILL.md +312 -312
- package/vendor/Server/Skills/arkts-library-stability-check/assets/REPORT_TEMPLATE.md +154 -154
- package/vendor/Server/Skills/arkts-library-stability-check/references/CHECKLIST.md +165 -165
- package/vendor/Server/Skills/arkts-library-stability-check/references/CODE_EXAMPLES.md +308 -308
- package/vendor/Server/Skills/arkts-library-stability-check/references/SCORING_RULES.md +90 -90
- package/vendor/Server/Skills/arkts-library-stability-check/scripts/validate-skill.cjs +282 -282
- package/vendor/Server/Skills/arkts-library-test-coverage-check/SKILL.md +360 -360
- package/vendor/Server/Skills/arkts-library-test-coverage-check/assets/REPORT_TEMPLATE.md +145 -145
- package/vendor/Server/Skills/arkts-library-test-coverage-check/references/CHECKLIST.md +252 -252
- package/vendor/Server/Skills/arkts-library-test-coverage-check/references/MCP_TOOL_USAGE.md +114 -114
- package/vendor/Server/Skills/arkts-library-test-coverage-check/scripts/validate-skill.cjs +262 -262
- package/vendor/Server/Skills/arkts-library-xts-code/SKILL.md +455 -455
- package/vendor/Server/Skills/arkts-library-xts-code/assets/report-template.md +60 -60
- package/vendor/Server/Skills/arkts-library-xts-code/references/ACCESS_MODIFIER_PRECHECK.md +76 -76
- package/vendor/Server/Skills/arkts-library-xts-code/references/BUILD_VERIFICATION.md +200 -200
- package/vendor/Server/Skills/arkts-library-xts-code/references/CODE_STANDARDS.md +518 -518
- package/vendor/Server/Skills/arkts-library-xts-code/references/SUBAGENT_PROMPT_TEMPLATE.md +276 -276
- package/vendor/Server/Skills/arkts-library-xts-code/references/SYSTEM_API_LOOKUP.md +92 -92
- package/vendor/Server/Skills/arkts-library-xts-code/references/XTS_TEMPLATE.md +767 -767
- package/vendor/Server/Skills/arkts-library-xts-code/scripts/build.ps1 +93 -93
- package/vendor/Server/Skills/arkts-library-xts-code/scripts/code-linter.cjs +432 -432
- package/vendor/Server/Skills/arkts-library-xts-code/scripts/migrate.cjs +851 -851
- package/vendor/Server/Skills/arkts-library-xts-code/scripts/ohpm-switch.cjs +788 -788
- package/vendor/Server/Skills/arkts-library-xts-code/scripts/precheck-access-modifiers.cjs +221 -221
- package/vendor/Server/Skills/arkts-library-xts-code-fix/SKILL.md +228 -228
- package/vendor/Server/Skills/arkts-library-xts-coverage/SKILL.md +97 -97
- package/vendor/Server/Skills/arkts-library-xts-doc/SKILL.md +194 -194
- package/vendor/Server/Skills/arkts-library-xts-doc/references/EXAMPLES.md +575 -575
- package/vendor/Server/Skills/arkts-library-xts-doc/references/TEMPLATE.md +574 -574
- package/vendor/Server/Skills/arkts-library-xts-doc/references/TESTABILITY_GUIDE.md +182 -182
- package/vendor/Server/Skills/arkts-library-xts-execution/SKILL.md +490 -490
- package/vendor/Server/Skills/arkts-library-xts-execution/references/error-fixing-examples.md +217 -217
- package/vendor/Server/Skills/arkts-library-xts-execution/scripts/build.ps1 +93 -93
- package/vendor/Server/Skills/arkts-library-xts-execution/scripts/code-linter.cjs +432 -432
- package/vendor/Server/Skills/arkts-library-xts-execution/scripts/migrate.cjs +851 -851
- package/vendor/Server/Skills/arkts-library-xts-execution/scripts/ohpm-switch.cjs +788 -788
- package/vendor/Server/Skills/flutter-code-check/SKILL.md +299 -299
- package/vendor/Server/Skills/flutter-code-check/assets/OUTPUT_TEMPLATE.md +311 -311
- package/vendor/Server/Skills/flutter-code-check/references/CHECKLIST.md +190 -190
- package/vendor/Server/Skills/flutter-code-check/references/PLATFORMS.md +133 -133
- package/vendor/Server/Skills/flutter-code-check/scripts/validate-skill.cjs +259 -259
- package/vendor/Server/Skills/flutter-interface/README.md +75 -75
- package/vendor/Server/Skills/flutter-interface/SKILL.md +291 -291
- package/vendor/Server/Skills/flutter-interface/references/EXAMPLES.md +336 -336
- package/vendor/Server/Skills/flutter-interface/references/GIT_CLONE_GUIDE.md +190 -190
- package/vendor/Server/Skills/flutter-interface/references/SCRIPT_REFERENCE.md +258 -258
- package/vendor/Server/Skills/flutter-interface/references/TEMPLATE.md +254 -254
- package/vendor/Server/Skills/flutter-library-consistency-check/SKILL.md +517 -517
- package/vendor/Server/Skills/flutter-library-consistency-check/references/CHECKLIST.md +381 -381
- package/vendor/Server/Skills/flutter-library-consistency-check/references/FUNCTION_COMPARISON_GUIDE.md +341 -341
- package/vendor/Server/Skills/flutter-library-consistency-check/references/PLATFORM_LIMITATION_GUIDE.md +71 -71
- package/vendor/Server/Skills/flutter-library-documentation-quality-check/SKILL.md +518 -518
- package/vendor/Server/Skills/flutter-library-documentation-quality-check/references/CHECKLIST.md +406 -406
- package/vendor/Server/Skills/flutter-library-memory-leak-check/SKILL.md +652 -652
- package/vendor/Server/Skills/flutter-library-memory-leak-check/references/CHECKLIST.md +396 -396
- package/vendor/Server/Skills/flutter-library-stability-check/SKILL.md +744 -744
- package/vendor/Server/Skills/flutter-library-stability-check/references/CHECKLIST.md +720 -720
- package/vendor/Server/Skills/flutter-library-test-coverage-check/SKILL.md +414 -414
- package/vendor/Server/Skills/flutter-library-test-coverage-check/assets/REPORT_TEMPLATE.md +150 -150
- package/vendor/Server/Skills/flutter-library-test-coverage-check/references/CHECKLIST.md +304 -304
- package/vendor/Server/Skills/flutter-library-test-coverage-check/references/SCORING_RULES.md +265 -265
- package/vendor/Server/Skills/flutter-library-test-coverage-check/references/SCRIPT_USAGE.md +286 -286
- package/vendor/Server/Skills/knowledge-import/SKILL.md +383 -383
- package/vendor/Server/Skills/knowledge-import/references/MCP_TOOL_USAGE.md +165 -165
- package/vendor/Server/Skills/knowledge-import/references/SKILL_LOCATOR_GUIDE.md +91 -91
- package/vendor/Server/Skills/knowledge-import/references/SKILL_OPTIMIZATION_GUIDE.md +127 -127
- package/vendor/Server/Skills/ohos-lib-pr-push/SKILL.md +453 -301
- package/vendor/Server/Skills/ohos-lib-pr-push/assets/PR_CHECKLIST.md +151 -0
- package/vendor/Server/Skills/ohos-lib-pr-push/assets/PR_ISSUE_TEMPLATE.md +257 -105
- package/vendor/Server/Skills/ohos-lib-pr-push/references/GITCODE_API.md +191 -127
- package/vendor/Server/Skills/ohos-lib-pr-push/scripts/gitcode-api.cjs +317 -208
- package/vendor/Server/Skills/rn-code-check/SKILL.md +320 -320
- package/vendor/Server/Skills/rn-code-check/references/API-GUIDE.md +234 -234
- package/vendor/Server/Skills/rn-code-check/references/CHECKLIST.md +188 -188
- package/vendor/Server/Skills/rn-code-check/references/REPORT-TEMPLATE.md +246 -246
- package/vendor/Server/Skills/rn-lib-add-example/SKILL.md +198 -198
- package/vendor/Server/Skills/rn-lib-add-example/references/APP_RENAME_GUIDE.md +40 -40
- package/vendor/Server/Skills/rn-lib-add-example/references/SHELL_ADAPTATION_CHECKLIST.md +78 -78
- package/vendor/Server/Skills/rn-lib-add-example/references/TEMPLATE_REPO_GUIDE.md +70 -70
- package/vendor/Server/Skills/rn-lib-add-example/references/VERIFICATION_GUIDE.md +47 -47
- package/vendor/Server/Skills/rn-lib-add-example/scripts/create-example.cjs +252 -252
- package/vendor/Server/Skills/rn-lib-update-doc/SKILL.md +176 -176
- package/vendor/Server/Skills/rn-lib-update-doc/config.json +5 -5
- package/vendor/Server/Skills/rn-lib-update-doc/references/changelog-template.md +35 -35
- package/vendor/Server/Skills/rn-lib-update-doc/references/format-diff.md +137 -137
- package/vendor/Server/Skills/rn-lib-update-doc/references/link-registry.json +33 -33
- package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2-overview.md +40 -40
- package/vendor/Server/Skills/rn-lib-update-doc/references/model-0.4.2.md +429 -429
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/detect-readme-format.cjs +105 -105
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/find-usage-doc.cjs +90 -90
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/link-verify.cjs +213 -213
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-changelog.cjs +73 -73
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-package-meta.cjs +258 -258
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/normalize-readme-links.cjs +341 -341
- package/vendor/Server/Skills/rn-lib-update-doc/scripts/resolve-usage-docs.cjs +67 -67
- package/vendor/Server/Skills/rn-library-consistency-check/SKILL.md +299 -299
- package/vendor/Server/Skills/rn-library-consistency-check/assets/REPORT_TEMPLATE.md +293 -293
- package/vendor/Server/Skills/rn-library-consistency-check/references/ARKTS_COMPONENT_CHECK_GUIDE.md +857 -857
- package/vendor/Server/Skills/rn-library-consistency-check/references/ARKTS_TURBOMODULE_CHECK_GUIDE.md +856 -856
- package/vendor/Server/Skills/rn-library-consistency-check/references/CHECKLIST.md +157 -157
- package/vendor/Server/Skills/rn-library-consistency-check/references/CPP_COMPONENT_CHECK_GUIDE.md +801 -801
- package/vendor/Server/Skills/rn-library-consistency-check/references/CPP_TURBOMODULE_CHECK_GUIDE.md +683 -683
- package/vendor/Server/Skills/rn-library-consistency-check/references/FUNCTION_COMPARISON_GUIDE.md +233 -233
- package/vendor/Server/Skills/rn-library-consistency-check/references/NATIVE_COMPONENT_IDENTIFICATION.md +1373 -1373
- package/vendor/Server/Skills/rn-library-consistency-check/references/SCORING_STANDARD.md +220 -220
- package/vendor/Server/Skills/rn-library-consistency-check/scripts/validate-skill.py +245 -245
- package/vendor/Server/Skills/rn-library-documentation-quality-check/SKILL.md +263 -263
- package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/MODEL.md +414 -414
- package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/MODEL_en.md +413 -413
- package/vendor/Server/Skills/rn-library-documentation-quality-check/assets/REPORT_TEMPLATE.md +311 -311
- package/vendor/Server/Skills/rn-library-documentation-quality-check/references/CHECK_CHECKLIST.md +355 -355
- package/vendor/Server/Skills/rn-library-documentation-quality-check/references/CROSS_VALIDATION_GUIDE.md +115 -115
- package/vendor/Server/Skills/rn-library-documentation-quality-check/references/DOC_COLLECTION_GUIDE.md +139 -139
- package/vendor/Server/Skills/rn-library-documentation-quality-check/references/EXAMPLES.md +586 -586
- package/vendor/Server/Skills/rn-library-documentation-quality-check/references/GOTCHAS.md +57 -57
- package/vendor/Server/Skills/rn-library-documentation-quality-check/scripts/validate-skill.py +259 -259
- package/vendor/Server/Skills/rn-library-interface-analyzer/SKILL.md +301 -301
- package/vendor/Server/Skills/rn-library-interface-analyzer/assets/REPORT_TEMPLATE.md +148 -148
- package/vendor/Server/Skills/rn-library-interface-analyzer/references/DOC_ANNOTATION_GUIDE.md +118 -118
- package/vendor/Server/Skills/rn-library-interface-analyzer/references/SCRIPT_USAGE_GUIDE.md +168 -168
- package/vendor/Server/Skills/rn-library-interface-analyzer/references/URL_PARSING_RULES.md +176 -176
- package/vendor/Server/Skills/rn-library-issue-generalizer/SKILL.md +274 -274
- package/vendor/Server/Skills/rn-library-issue-generalizer/assets/case-template.md +45 -45
- package/vendor/Server/Skills/rn-library-issue-generalizer/assets/rule-template.md +25 -25
- package/vendor/Server/Skills/rn-library-issue-generalizer/references/PR_FETCH_GUIDE.md +61 -61
- package/vendor/Server/Skills/rn-library-issue-generalizer/references/RULE_TEMPLATE_GUIDE.md +165 -165
- package/vendor/Server/Skills/rn-library-issue-generalizer/scripts/fetch-pr-info.py +239 -239
- package/vendor/Server/Skills/rn-library-known-issue-check/SKILL.md +263 -263
- package/vendor/Server/Skills/rn-library-known-issue-check/assets/REPORT_TEMPLATE.md +96 -96
- package/vendor/Server/Skills/rn-library-known-issue-check/references/COMPLIANCE_CHECKLIST.md +57 -57
- package/vendor/Server/Skills/rn-library-known-issue-check/references/INSPECTION_GUIDE.md +99 -99
- package/vendor/Server/Skills/rn-library-known-issue-check/references/PRESCREEN_GUIDE.md +64 -64
- package/vendor/Server/Skills/rn-library-known-issue-check/references/SOURCE_PREP_GUIDE.md +74 -74
- package/vendor/Server/Skills/rn-library-known-issue-check/scripts/validate-known-issue-report.py +164 -164
- package/vendor/Server/Skills/rn-library-memory-leak-check/SKILL.md +356 -339
- package/vendor/Server/Skills/rn-library-memory-leak-check/assets/REPORT_TEMPLATE.md +85 -83
- package/vendor/Server/Skills/rn-library-memory-leak-check/references/CHECKLIST.md +905 -859
- package/vendor/Server/Skills/rn-library-memory-leak-check/references/HARMONY_CODE_PATTERNS.md +124 -122
- package/vendor/Server/Skills/rn-library-memory-leak-check/scripts/scan_harmony_code.py +287 -279
- package/vendor/Server/Skills/rn-library-stability-check/SKILL.md +273 -273
- package/vendor/Server/Skills/rn-library-stability-check/assets/REPORT_TEMPLATE.md +129 -129
- package/vendor/Server/Skills/rn-library-stability-check/references/CHECKLIST.md +581 -581
- package/vendor/Server/Skills/rn-library-stability-check/references/SCORING_RULES.md +138 -138
- package/vendor/Server/Skills/rn-library-stability-check/scripts/scan-harmony-code.py +168 -168
- package/vendor/Server/Skills/rn-library-test-coverage-check/SKILL.md +526 -506
- package/vendor/Server/Skills/rn-library-test-coverage-check/references/CHECKLIST.md +321 -280
- package/vendor/Server/Skills/rn-library-test-coverage-check/references/DEMO_LOCATION.md +221 -221
- package/vendor/Server/Skills/rn-library-test-coverage-check/references/REPORT_TEMPLATE.md +220 -209
- package/vendor/Server/Skills/rn-library-test-coverage-check/references/SCRIPT_USAGE.md +325 -325
- package/vendor/Server/Skills/rn-ohos-xts-generator/SKILL.md +279 -279
- package/vendor/Server/Skills/rn-ohos-xts-generator/assets/TEST_FILE_TEMPLATES.md +404 -404
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/BUILD_TROUBLESHOOTING.md +185 -185
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/BUILD_WORKFLOW.md +265 -265
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/COMMON_CONFIG.md +189 -189
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/CONFIG_GUIDE.md +203 -203
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/COVERAGE_ANALYZER.md +147 -147
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/DESIGN_DOC_GUIDE.md +148 -148
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/GENERATION_FLOW.md +165 -165
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/GENERATION_STRATEGY.md +195 -195
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/HARMONY_SCANNER.md +249 -249
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/JEST_FRAMEWORK.md +235 -235
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/PLATFORM_COMPAT.md +161 -161
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/RN_TEST_PATTERNS.md +413 -413
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/SOURCE_PARSER.md +235 -235
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/TEST_CONVENTIONS.md +245 -245
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/TROUBLESHOOTING.md +282 -282
- package/vendor/Server/Skills/rn-ohos-xts-generator/references/USAGE_GUIDE.md +251 -251
- package/vendor/Server/Skills/rnoh-cptf-api-test/SKILL.md +469 -469
- package/vendor/Server/Skills/rnoh-cptf-api-test/assets/CPTF_TEST_TEMPLATE.md +310 -310
- package/vendor/Server/Skills/rnoh-cptf-api-test/assets/DEMO_PAGE_TEMPLATE.md +303 -303
- package/vendor/Server/Skills/rnoh-cptf-api-test/references/CPTF_TEST_GENERATION_GUIDE.md +421 -421
- package/vendor/Server/Skills/rnoh-cptf-api-test/references/DEMO_GENERATION_GUIDE.md +358 -358
- package/vendor/Server/Skills/rnoh-cptf-api-test/references/QUALITY_CHECKLIST.md +114 -114
- package/vendor/Server/Skills/rnoh-cptf-api-test/references/SPEC_PARSING_GUIDE.md +274 -274
- package/vendor/Server/Skills/rnoh-cptf-api-test/scripts/validate-rnoh-cptf-api-test.sh +185 -185
- package/vendor/Server/Skills/rnoh-cptf-demo-test/SKILL.md +191 -191
- package/vendor/Server/Skills/rnoh-cptf-demo-test/assets/TEST_TEMPLATE.md +216 -216
- package/vendor/Server/Skills/rnoh-cptf-demo-test/references/CPTF_SETUP.md +107 -107
- package/vendor/Server/Skills/rnoh-cptf-demo-test/references/DEMO_ANALYSIS.md +120 -120
- package/vendor/Server/Skills/rnoh-cptf-demo-test/scripts/validate-rnoh-cptf-test.sh +108 -108
- package/vendor/Server/Skills/rnoh-cptf-test-run/SKILL.md +237 -237
- package/vendor/Server/Skills/rnoh-cptf-test-run/references/DEBUG_PLAYBOOK.md +261 -261
- package/vendor/Server/Skills/rnoh-cptf-test-run/scripts/validate-run-env.sh +112 -112
- package/vendor/Server/Skills/rnoh-lib-code-adapt/SKILL.md +497 -497
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/adapt-checklist.md +270 -270
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/api-migration-checklist.md +164 -164
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/common-compile-errors.md +556 -556
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/deveco-cli-tools.md +459 -459
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/edge-cases.md +65 -65
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/har-tgz-build.md +512 -512
- package/vendor/Server/Skills/rnoh-lib-code-adapt/references/version-compat-matrix.md +132 -132
- package/vendor/Server/Skills/rnoh-lib-code-adapt/scripts/auto-integrate.sh +424 -424
- package/vendor/Server/Skills/rnoh-lib-demo-coverage/SKILL.md +137 -137
- package/vendor/Server/Skills/rnoh-lib-demo-create/SKILL.md +306 -306
- package/vendor/Server/Skills/rnoh-lib-demo-create/assets/DEMO_PAGE_TEMPLATE.md +485 -485
- package/vendor/Server/Skills/rnoh-lib-demo-create/assets/INDEX_TEMPLATE.md +172 -172
- package/vendor/Server/Skills/rnoh-lib-demo-create/references/DEMO_CODE_RULES.md +422 -422
- package/vendor/Server/Skills/rnoh-lib-demo-create/references/QUALITY_CHECKLIST.md +95 -95
- package/vendor/Server/Skills/rnoh-lib-demo-create/references/SOURCE_EXPLORATION.md +169 -169
- package/vendor/Server/Skills/rnoh-lib-demo-doc/SKILL.md +554 -554
- package/vendor/Server/Skills/rnoh-lib-demo-doc/assets/DEMO_DOC_TEMPLATE.md +106 -106
- package/vendor/Server/Skills/rnoh-lib-demo-doc/references/COVERAGE_INCREMENTAL.md +216 -216
- package/vendor/Server/Skills/rnoh-lib-demo-doc/references/DEMO_DESIGN_RULES.md +413 -413
- package/vendor/Server/Skills/rnoh-lib-demo-doc/references/OUTPUT_FORMAT.md +269 -269
- package/vendor/Server/Skills/rnoh-lib-demo-doc/references/QUALITY_CHECKLIST.md +98 -98
- package/vendor/Server/Skills/rnoh-lib-func-test/SKILL.md +337 -337
- package/vendor/Server/Skills/rnoh-lib-rnt-search/SKILL.md +722 -722
- package/vendor/Server/Skills/rnoh-lib-rnt-search/assets/PORT_REPORT_TEMPLATE.md +219 -219
- package/vendor/Server/Skills/rnoh-lib-rnt-search/references/DEMO_PORTING_GUIDE.md +345 -345
- package/vendor/Server/Skills/rnoh-lib-rnt-search/references/PORT_VERIFICATION.md +269 -269
- package/vendor/Server/Skills/rnoh-lib-rnt-search/references/RNT_PROJECT_STRUCTURE.md +173 -173
- package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/analyze-demo-deps.cjs +267 -267
- package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/detect-rnoh-version.cjs +174 -174
- package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/find-rnt-demo.sh +111 -111
- package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/port-demo.sh +186 -186
- package/vendor/Server/Skills/rnoh-lib-rnt-search/scripts/read-lib-meta.cjs +150 -150
- package/vendor/Server/Skills/rnoh-lib-test-align/SKILL.md +296 -296
- package/vendor/Server/Skills/rnoh-lib-test-align/references/jest-troubleshooting.md +371 -371
- package/vendor/Server/Skills/rnoh-lib-test-align/references/port-test-demo-guide.md +212 -212
- package/vendor/Server/Skills/rnoh-lib-test-align/references/runtime-troubleshooting.md +345 -345
- package/vendor/Server/Skills/rnoh-lib-test-align/references/unit-test-template.md +223 -223
- package/vendor/Server/Skills/rnoh-lib-test-align/scripts/port-test-demo.sh +1053 -1053
- package/vendor/Server/Skills/rnoh-lib-version-diff/SKILL.md +295 -255
- package/vendor/Server/Skills/rnoh-lib-version-diff/references/OHOS_ADAPTATION.md +82 -77
- package/vendor/Server/Skills/rnoh-lib-version-diff/references/OHOS_API_LOOKUP.md +224 -224
- package/vendor/Server/Skills/rnoh-lib-version-diff/references/script-reference.md +175 -174
- package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/detect-upstream-version.js +967 -967
- package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/generate-diff.js +1798 -1798
- package/vendor/Server/Skills/rnoh-lib-version-diff/scripts/package.json +5 -5
- package/vendor/Server/Skills/rnoh-lib-version-diff/templates/report-template.md +180 -137
- package/vendor/Server/Skills/rnoh-lib-xts-coverage/SKILL.md +145 -145
- package/vendor/Server/Skills/skill-generator/SKILL.md +365 -365
- package/vendor/Server/Skills/skill-generator/assets/SKILL_TEMPLATE.md +183 -183
- package/vendor/Server/Skills/skill-generator/references/COMPLIANCE_CHECKLIST.md +82 -82
- package/vendor/Server/Skills/skill-generator/references/KB_QUERY_GUIDE.md +110 -110
- package/vendor/Server/Skills/skill-generator/references/MCP_TOOL_DISCOVERY.md +122 -122
- package/vendor/Server/Skills/skill-generator/references/SKILL_SPEC.md +121 -121
- package/vendor/Server/Skills/skill-generator/scripts/validate-skill.cjs +259 -259
- package/vendor/Server/Skills/task-analysis/SKILL.md +234 -234
- package/vendor/Server/Skills/task-analysis/assets/OUTPUT_EXAMPLES.md +160 -160
- package/vendor/Server/Skills/task-analysis/references/ACCEPTANCE_CRITERIA_GUIDE.md +190 -190
- package/vendor/Server/Skills/task-analysis/references/ANALYSIS_SCHEMA.md +224 -224
- package/vendor/Server/Skills/task-analysis/references/INTEGRATION_CONTEXT.md +162 -162
- package/vendor/Server/Skills/task-analysis/references/LESSONS_LEARNED.md +55 -55
- package/vendor/Server/Skills/task-analysis/references/REPLAN_CONTEXT_GUIDE.md +126 -126
- package/vendor/Server/Skills/task-analysis/scripts/validate-analysis-output.sh +256 -256
- package/vendor/Server/Skills/task-decomposition/SKILL.md +528 -528
- package/vendor/Server/Skills/task-decomposition/assets/OUTPUT_EXAMPLES.md +451 -451
- package/vendor/Server/Skills/task-decomposition/references/ACCEPTANCE_CRITERIA_GUIDE.md +179 -179
- package/vendor/Server/Skills/task-decomposition/references/DEPENDENCY_GRAPH_GUIDE.md +152 -152
- package/vendor/Server/Skills/task-decomposition/references/INTEGRATION_CONTEXT.md +175 -175
- package/vendor/Server/Skills/task-decomposition/references/REPLAN_CONTEXT_GUIDE.md +195 -195
- package/vendor/Server/Skills/task-decomposition/references/TASK_DECOMPOSITION_TEMPLATES.md +226 -226
- package/vendor/Server/Skills/task-decomposition/scripts/list-available-skills.cjs +263 -263
- package/vendor/Server/Skills/task-decomposition/scripts/skill-blacklist.json +29 -29
- package/vendor/Server/Skills/task-decomposition/scripts/validate-decomposition-output.cjs +376 -376
- package/vendor/Server/Skills/task-decomposition/scripts/validate-param-consistency.cjs +259 -259
- package/vendor/Server/Skills/task-decomposition/scripts/validate-specified-skills.cjs +216 -216
- package/vendor/Server/Skills/task-decomposition/scripts/validate-step-graph.cjs +424 -424
- package/vendor/Server/Skills/tpc-cpp-check/SKILL.md +427 -427
- package/vendor/Server/Skills/tpc-cpp-check/references/CHECKLIST.md +214 -214
- package/vendor/Server/Skills/tpc-cpp-check/references/HPKBUILD_GUIDE.md +235 -235
- package/vendor/Server/Skills/tpc-cpp-check/references/REPORT_TEMPLATE.md +250 -250
- package/vendor/Server/TestCheck/TestCheck.js +775 -775
- package/vendor/Server/TestCheck/index.js +11 -11
- package/vendor/Server/library/McpToolGuide.js +280 -280
- package/vendor/Server/library/StatsService.js +126 -126
- package/vendor/Server/library/cstTime.js +16 -16
- package/vendor/VERSION +3 -3
- package/workflows/pr-check.mjs +105 -105
- package/workflows/pr-push.mjs +193 -0
- package/vendor/Server/Agent/SkillSelector/types.js +0 -63
|
@@ -1,856 +1,856 @@
|
|
|
1
|
-
# ArkTS TurboModule 层一致性检视指南
|
|
2
|
-
|
|
3
|
-
本指南定义 RN 鸿蒙化一致性检视中 **ArkTS TurboModule 层**(TurboModule ArkTS 实现类、generated Spec 类型、方法实现、常量导出、回调机制)的检视规范,确保 AI Agent 能系统性地读取和分析 ArkTS TurboModule 代码,检测方法 Stub、方法缺失、常量导出缺失、回调逻辑不一致等问题。
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
## 1. 适用条件与前置依赖
|
|
8
|
-
|
|
9
|
-
### 1.1 适用条件
|
|
10
|
-
|
|
11
|
-
当 `harmony/<module>/src/main/ets/` 目录存在 TurboModule 实现文件(`*TurboModule.ets`)时,必须执行本指南的检视流程。若不存在,标注"⚠️ 无 ArkTS TurboModule 实现"并跳过。
|
|
12
|
-
|
|
13
|
-
判定条件:
|
|
14
|
-
|
|
15
|
-
| 条件 | 判定 |
|
|
16
|
-
|------|------|
|
|
17
|
-
| `harmony/<module>/src/main/ets/*TurboModule.ets` 存在 | ✅ ArkTS TurboModule 实现(必须检视) |
|
|
18
|
-
| `generated/turboModules/TurboModuleName.ts` 存在 | ✅ Codegen Spec 类型定义(必须检视) |
|
|
19
|
-
| 以上均不存在 | ⚠️ 无 ArkTS TurboModule 层,跳过本指南 |
|
|
20
|
-
|
|
21
|
-
### 1.2 前置依赖
|
|
22
|
-
|
|
23
|
-
- Phase 0 中已定位的 TurboModule 名(从 C++ FactoryDelegate 或 JS Spec 提取)
|
|
24
|
-
- C++ TurboModule JSIBinder 方法列表(来自 CPP_TURBOMODULE_CHECK_GUIDE)
|
|
25
|
-
- JS 层 TurboModule Spec 定义(`NativeRNCWebViewModule.ts` 等文件)
|
|
26
|
-
- C++ TurboModuleFactoryDelegate 注册名列表
|
|
27
|
-
|
|
28
|
-
### 1.3 与其他检视指南的关系
|
|
29
|
-
|
|
30
|
-
| 检视指南 | 检视层级 | 本指南关注点 |
|
|
31
|
-
|----------|----------|-------------|
|
|
32
|
-
| CPP_COMPONENT_CHECK_GUIDE | C++ 组件层 | JSIBinder Props 序列化、NapiBinder 桥接、Package 注册 |
|
|
33
|
-
| CPP_TURBOMODULE_CHECK_GUIDE | C++ TurboModule 层 | TurboModuleFactoryDelegate 注册、TurboModule JSIBinder 方法绑定 |
|
|
34
|
-
| ARKTS_COMPONENT_CHECK_GUIDE | ArkTS @Component 层 | rawProps 读取、Commands switch、事件 emit、build() 渲染 |
|
|
35
|
-
| ARKTS_TURBOMODULE_CHECK_GUIDE(本文件) | ArkTS TurboModule 层 | 方法实现完整性、Stub 检测、常量导出、回调逻辑、行为对比 |
|
|
36
|
-
|
|
37
|
-
---
|
|
38
|
-
|
|
39
|
-
## 2. 文件定位与读取
|
|
40
|
-
|
|
41
|
-
### 2.1 ArkTS TurboModule 实现定位
|
|
42
|
-
|
|
43
|
-
**搜索路径**:`harmony/<module>/src/main/ets/`
|
|
44
|
-
|
|
45
|
-
| 步骤 | 搜索目标 | 搜索模式 | 目的 |
|
|
46
|
-
|------|----------|----------|------|
|
|
47
|
-
| 2.1a | TurboModule 实现文件 | `*TurboModule.ets` | 定位 ArkTS TurboModule 实际实现类 |
|
|
48
|
-
| 2.1b | TurboModule 继承方式 | `extends AnyThreadTurboModule` / `extends TurboModule` | 确定线程模型 |
|
|
49
|
-
| 2.1c | TurboModule Spec 实现 | `implements TM.Xxx.Spec` | 确认是否实现了 generated Spec 接口 |
|
|
50
|
-
|
|
51
|
-
**必须读取的文件清单**:
|
|
52
|
-
|
|
53
|
-
| # | 文件 | 说明 |
|
|
54
|
-
|---|------|------|
|
|
55
|
-
| 1 | `*TurboModule.ets`(主实现文件) | 包含 TurboModule 类声明、方法实现、常量导出 |
|
|
56
|
-
| 2 | `generated/turboModules/TurboModuleName.ts`(若存在) | Codegen Spec 类型定义(NAME 常量 + Spec 接口) |
|
|
57
|
-
| 3 | `generated/turboModules/ts.ts`(若存在) | TurboModule 命名空间导出汇总 |
|
|
58
|
-
|
|
59
|
-
### 2.2 ArkTS TurboModule 必读内容(五个维度)
|
|
60
|
-
|
|
61
|
-
#### 维度 A:类声明与 Spec 实现
|
|
62
|
-
|
|
63
|
-
```
|
|
64
|
-
1. 类声明
|
|
65
|
-
→ class XxxTurboModule extends AnyThreadTurboModule / TurboModule
|
|
66
|
-
→ 是否 implements TM.Xxx.Spec(Codegen 模式)
|
|
67
|
-
→ 是否手写 Spec 接口(Legacy 模式)
|
|
68
|
-
|
|
69
|
-
2. NAME 常量
|
|
70
|
-
→ TurboModule 注册名(TM.Xxx.NAME 或手写常量)
|
|
71
|
-
→ 与 JS Spec TurboModuleRegistry.getEnforcing<Spec>('XXX') 的模块名对比
|
|
72
|
-
→ 与 C++ FactoryDelegate 注册名对比
|
|
73
|
-
|
|
74
|
-
3. 构造方法
|
|
75
|
-
→ constructor(ctx: TurboModuleContext, name: string)
|
|
76
|
-
→ 是否在构造中初始化了必要的状态变量
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
**类声明提取模板**:
|
|
80
|
-
|
|
81
|
-
```markdown
|
|
82
|
-
| # | TurboModule 名 | ArkTS 类名 | ArkTS 父类 | implements Spec? | NAME 常量值 | JS Spec 注册名 | C++ FactoryDelegate 注册名 | 状态 |
|
|
83
|
-
|---|--------------|-----------|-----------|-----------------|------------|--------------|------------------------|------|
|
|
84
|
-
| 1 | `RNCWebViewModule` | `WebViewTurboModule` | `AnyThreadTurboModule` | ✅ TM.RNCWebViewModule.Spec | `RNCWebViewModule` | `RNCWebViewModule` ✅ | `RNCWebViewModule` ✅ | ✅ 全链路一致 |
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
#### 维度 B:方法实现完整性
|
|
88
|
-
|
|
89
|
-
```
|
|
90
|
-
1. 方法名列表
|
|
91
|
-
→ 提取所有 public 方法名
|
|
92
|
-
→ 与 JS Spec 方法名对比
|
|
93
|
-
→ 与 generated Spec 接口方法名对比
|
|
94
|
-
|
|
95
|
-
2. 方法签名
|
|
96
|
-
→ 提取每个方法的参数类型和返回值类型
|
|
97
|
-
→ 与 JS Spec 签名对比
|
|
98
|
-
|
|
99
|
-
3. 方法实现状态
|
|
100
|
-
→ 是否为正常实现(调用了 @ohos API 或业务逻辑)
|
|
101
|
-
→ 是否为 Stub(返回固定值、空方法体、仅日志)
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
**方法级对比模板**:
|
|
105
|
-
|
|
106
|
-
```markdown
|
|
107
|
-
| # | 方法名 | JS Spec 签名 | generated Spec 签名 | ArkTS TurboModule 签名 | ArkTS 文件:行号 | 实现状态 | 扣分 |
|
|
108
|
-
|---|--------|-------------|--------------------|----------------------|---------------|----------|------|
|
|
109
|
-
| 1 | `isFileUploadSupported` | `(): Promise<boolean>` | `(): Promise<boolean>` | `(): Promise<boolean>` | `WebViewTurboModule.ets:14` | ⚠️ Stub(固定返回 true) | -8 |
|
|
110
|
-
| 2 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | `(shouldStart: boolean, lockIdentifier: number): void` | `(shouldStart: boolean, lockIdentifier: number): void` | `WebViewTurboModule.ets:18` | ✅ 正常实现 | 0 |
|
|
111
|
-
| 3 | `injectJavaScript` | `(script: string): void` | `(script: string): void` | ⛔ 不存在 | — | ❌ 方法缺失 | -15 |
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
#### 维度 C:Stub 检测
|
|
115
|
-
|
|
116
|
-
```
|
|
117
|
-
1. Stub 识别特征
|
|
118
|
-
→ 方法体仅有 return 语句,返回固定值
|
|
119
|
-
→ 未调用任何 @ohos 模块 API
|
|
120
|
-
→ 未执行实际业务操作
|
|
121
|
-
→ 仅日志输出(console.log)
|
|
122
|
-
|
|
123
|
-
2. Stub 合理性判定
|
|
124
|
-
→ 与 Android/iOS 同名方法对比行为
|
|
125
|
-
→ iOS 也返回固定值 → 合理 Stub(不扣分)
|
|
126
|
-
→ Android 有实际业务逻辑 → 致命 Stub(扣分)
|
|
127
|
-
```
|
|
128
|
-
|
|
129
|
-
**Stub 检测模板**:
|
|
130
|
-
|
|
131
|
-
```markdown
|
|
132
|
-
| # | 方法名 | ArkTS 文件:行号 | Stub 代码片段 | Android 实现 | iOS 实现 | Stub 合理性 | 缺失逻辑 | 严重度 | 扣分 |
|
|
133
|
-
|---|--------|---------------|--------------|-------------|---------|------------|---------|--------|------|
|
|
134
|
-
| 1 | `isFileUploadSupported` | `WebViewTurboModule.ets:14` | `return Promise.resolve(true)` | ✅ Android 5+ 返回 true | ✅ 始终返回 YES | ✅ 三平台一致 | 无 | ⚠️ 合理 | 0 |
|
|
135
|
-
| 2 | `removeBond` | `BleTurboModule.ets:278` | `return true;` | ✅ 调用 BluetoothDevice.removeBond() | ✅ 调用 CBCentralManager.remove() | ❌ 缺失实际解绑 | 实际解绑操作 | ❌ 致命 | -8 |
|
|
136
|
-
| 3 | `requestPriority` | `BleTurboModule.ets:455` | `// todo: implement` | ✅ 调用 gatt.requestConnectionPriority() | ⛔ 不支持 | ❌ 空方法体 | 优先级请求 | ❌ 致命 | -8 |
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
#### 维度 D:常量导出
|
|
140
|
-
|
|
141
|
-
```
|
|
142
|
-
1. getConstants() 方法(若有)
|
|
143
|
-
→ 提取所有导出的常量名和值
|
|
144
|
-
→ 与 Android/iOS getConstants() 对比
|
|
145
|
-
|
|
146
|
-
2. 常量值一致性
|
|
147
|
-
→ 各平台导出的常量值是否一致
|
|
148
|
-
→ 常量名拼写是否一致
|
|
149
|
-
```
|
|
150
|
-
|
|
151
|
-
**常量导出对比模板**:
|
|
152
|
-
|
|
153
|
-
```markdown
|
|
154
|
-
| # | 常量名 | Android getConstants() | iOS getConstants() | ArkTS TurboModule getConstants() | ArkTS 文件:行号 | 值一致性 | 状态 | 扣分 |
|
|
155
|
-
|---|--------|----------------------|--------------------|--------------------------------|---------------|---------|------|------|
|
|
156
|
-
| 1 | `Scale` | `{Scale: 0.0001}` | `{Scale: 0.0001}` | `{Scale: 0.0001}` | `MapsTurboModule.ets:25` | ✅ | ✅ 一致 | 0 |
|
|
157
|
-
| 2 | `ConnectionPriority` | `{HIGH: 1, BALANCED: 0, LOW_POWER: -1}` | ⛔ 无 | ⛔ 无 | — | — | ⚠️ 仅 Android 有 | -3 |
|
|
158
|
-
```
|
|
159
|
-
|
|
160
|
-
#### 维度 E:回调/事件机制
|
|
161
|
-
|
|
162
|
-
```
|
|
163
|
-
1. 回调方法
|
|
164
|
-
→ TurboModule 中定义的回调方法(如 shouldStartLoadWithLockIdentifier)
|
|
165
|
-
→ 回调触发时机和方式
|
|
166
|
-
|
|
167
|
-
2. 事件发送
|
|
168
|
-
→ TurboModule 是否通过 emitDeviceEvent / sendEvent 发送事件
|
|
169
|
-
→ 事件名与 payload 是否与 Android/iOS 一致
|
|
170
|
-
|
|
171
|
-
3. 回调参数类型
|
|
172
|
-
→ 回调方法的参数类型映射是否正确
|
|
173
|
-
→ 与 JS Spec 回调参数类型对比
|
|
174
|
-
```
|
|
175
|
-
|
|
176
|
-
**回调/事件对比模板**:
|
|
177
|
-
|
|
178
|
-
```markdown
|
|
179
|
-
| # | 回调/事件名 | JS Spec 定义 | Android 实现 | iOS 实现 | ArkTS TurboModule 实现 | ArkTS 文件:行号 | 行为一致性 | 扣分 |
|
|
180
|
-
|---|------------|-------------|-------------|---------|----------------------|---------------|-----------|------|
|
|
181
|
-
| 1 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | ✅ AtomicReference + notify | ✅ DecisionManager setResult | ✅ ShouldStartParams + lockState | `WebViewTurboModule.ets:18` | ✅ 功能一致 | 0 |
|
|
182
|
-
| 2 | `onBluetoothStateChange` | `event: {state: string}` | ✅ sendEvent("onBluetoothStateChange", {state}) | ✅ RCTEventEmitter | ⛔ 未发送事件 | — | ❌ 事件缺失 | -8 |
|
|
183
|
-
```
|
|
184
|
-
|
|
185
|
-
---
|
|
186
|
-
|
|
187
|
-
## 3. 检视项与扣分规则
|
|
188
|
-
|
|
189
|
-
> 本指南覆盖 `arktsTM` 类型实体,检视项按三个关键检查点组织:**函数签名、返回值、实现逻辑**。**最关键检查项为实现逻辑一致性**。
|
|
190
|
-
|
|
191
|
-
### 3.0 前置过滤:原生注册缺失检测(优先级最高)
|
|
192
|
-
|
|
193
|
-
> ⚠️ **此步骤必须在所有方法级检视(3.1-3.3)之前执行**。未注册的 TM 整体不可达,其内部方法逐项检视会导致重复扣分且无实际意义。
|
|
194
|
-
|
|
195
|
-
- **检查项**: 原生注册缺失检测
|
|
196
|
-
- **适用场景**: 当 JS/TS Spec 注册的 TurboModule 名在 ArkTS Factory 中未注册时,该 TM 整体不可达(JS 调用 `TurboModuleRegistry.getEnforcing` 将失败),此时应跳过该 TM 内部所有方法的逐项检视。
|
|
197
|
-
- **特征检索方式**:
|
|
198
|
-
1. 在 `generated/turboModules/*.ts` 中提取所有 TurboModule `NAME` 常量
|
|
199
|
-
2. 在 `*Package.ets` 中提取 `createTurboModule()` 方法的 `if(name===)` 条件
|
|
200
|
-
- **检视步骤**:
|
|
201
|
-
1. 读取 `generated/turboModules/*.ts`,提取所有 TurboModule NAME 常量 → 列表TM_js
|
|
202
|
-
2. 读取 `*Package.ets` 的 `createTurboModule` 方法,提取所有 `if(name===)` 条件中的 TM 名 → 列表TM_registered
|
|
203
|
-
3. 对每个 TM_js 中的名称,检查是否存在于 TM_registered 中
|
|
204
|
-
4. 判定规则:
|
|
205
|
-
- **TM 已注册** → ✅ 通过,继续 3.1-3.3 的正常方法级检视
|
|
206
|
-
- **TM 未注册** → ❌ 致命,扣 -15/实体名,**跳过该 TM 内部所有方法的逐项检视**(方法存在性、签名一致性、参数类型、返回值、实现逻辑等均不再检查)
|
|
207
|
-
5. 将跳过的 TM 记入输出表,明确标注"⛔ 跳过逐项检查"
|
|
208
|
-
- **扣分规则**: 未注册→致命-15/实体名;跳过的方法不计入致命问题计数
|
|
209
|
-
- **输出格式**:
|
|
210
|
-
|
|
211
|
-
```markdown
|
|
212
|
-
| # | 实体类型 | JS/TS Spec 注册名 | ArkTS Factory 注册 | 状态 | 致命度 | 扣分 | 内部方法检查 |
|
|
213
|
-
|---|---------|-----------------|-------------------|------|--------|------|------------|
|
|
214
|
-
| 1 | TurboModule | `RNCWebViewModule` | ✅ 已注册 | ✅ 通过 | — | 0 | 继续逐项检视 |
|
|
215
|
-
| 2 | TurboModule | `RNCWebView` | ❌ 未注册 | ❌ 致命 | -15 | ⛔ 跳过 |
|
|
216
|
-
```
|
|
217
|
-
|
|
218
|
-
**⚠️ 关键说明**:
|
|
219
|
-
- 跳过的 TM 内部方法**不计入致命问题计数**,避免因方法级重复扣分触发归零规则
|
|
220
|
-
- 此规则仅适用于 TM 整体未注册(无 ArkTS Factory 条件)的场景。若 TM 已注册但部分方法缺失,仍按检查项 3(方法存在性)的正常规则扣分
|
|
221
|
-
|
|
222
|
-
### 3.1 检查点:函数签名(仅对已注册的 TM 执行)
|
|
223
|
-
|
|
224
|
-
#### 检查项概要
|
|
225
|
-
|
|
226
|
-
| # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
|
|
227
|
-
|---|--------|------|----------|----------|--------|
|
|
228
|
-
| 1 | NAME常量一致性 | ①契约一致性 | ArkTS NAME vs JS Spec注册名 vs C++ FactoryDelegate注册名 | 不一致→-5分/个 | 中等 |
|
|
229
|
-
| 2 | 方法签名一致性 | ①契约一致性 | ArkTS方法签名 vs generated Spec签名 vs JS Spec签名 | 签名不匹配→-8分/个 | 严重 |
|
|
230
|
-
| 3 | 方法存在性 | ①契约一致性 | JS Spec方法名 vs ArkTS TurboModule方法名 | 方法缺失→-15分/个 | 致命 |
|
|
231
|
-
| 4 | 参数数量 | ①契约一致性 | JS Spec参数数量 vs ArkTS TurboModule参数数量 | 不匹配→-8分 | 致命 |
|
|
232
|
-
| 5 | 参数类型 | ①契约一致性 | ArkTS TurboModule参数类型 vs JS Spec参数类型 | 类型致命错误→-10分/个 | 致命 |
|
|
233
|
-
| 6 | 参数顺序 | ①契约一致性 | JS Spec参数位置 vs ArkTS TurboModule参数位置 | 顺序错误→-6分 | 中等 |
|
|
234
|
-
| 7 | 方法签名vs Android | ②平台实现差异 | ArkTS TurboModule方法签名 vs Android @ReactMethod签名 | 合并至①检查 | — |
|
|
235
|
-
| 8 | 方法签名vs iOS | ②平台实现差异 | ArkTS TurboModule方法签名 vs iOS RCT_EXPORT_METHOD签名 | 合并至①检查 | — |
|
|
236
|
-
| 9 | Spec接口实现 | ③架构桥接一致性 | ArkTS TurboModule是否implements generated Spec接口 | 未实现→-8分/个 | 严重 |
|
|
237
|
-
|
|
238
|
-
> ⚠️ **前置过滤规则(3.0节)优先级最高**:检查项 1-9 仅对**已注册的 TM** 执行。未注册的 TM 整体在 3.0 中已扣致命-15,其内部方法不再逐项检视。
|
|
239
|
-
|
|
240
|
-
#### ①契约一致性
|
|
241
|
-
|
|
242
|
-
##### 检查项1:NAME常量一致性
|
|
243
|
-
|
|
244
|
-
- **检查项**: NAME常量一致性
|
|
245
|
-
- **特征检索方式**: 在 `*TurboModule.ets` 中 grep `NAME = ` 或 `static NAME`;在 JS Spec 中 grep `TurboModuleRegistry.getEnforcing`;在 C++ FactoryDelegate 中 grep `if(name=="`
|
|
246
|
-
- **检视步骤**:
|
|
247
|
-
1. 读取 `*TurboModule.ets`,提取 NAME 常量值(格式为 `TM.Xxx.NAME` 或 `static NAME = "xxx"`)
|
|
248
|
-
2. 读取 JS Spec 文件,提取 `TurboModuleRegistry.getEnforcing<Spec>('XXX')` 中的模块注册名
|
|
249
|
-
3. 读取 C++ FactoryDelegate 文件,提取 `if(name=="XXX")` 条件中的注册名
|
|
250
|
-
4. 比较三者:ArkTS NAME值、JS Spec注册名、C++ FactoryDelegate注册名
|
|
251
|
-
5. 判定规则:三者完全一致→通过;任一不一致→标注不一致并扣分
|
|
252
|
-
- **扣分规则**: 不一致→中等-5分/个
|
|
253
|
-
- **输出格式**:
|
|
254
|
-
|
|
255
|
-
```markdown
|
|
256
|
-
| # | NAME来源 | NAME值 | 是否一致 | 扣分 |
|
|
257
|
-
|---|---------|--------|---------|------|
|
|
258
|
-
| 1 | ArkTS TurboModule NAME常量 | `"RNCWebViewModule"` | — | — |
|
|
259
|
-
| 2 | JS Spec TurboModuleRegistry注册名 | `'RNCWebViewModule'` | ✅/❌ | 0/-5 |
|
|
260
|
-
| 3 | C++ FactoryDelegate注册名 | `"RNCWebViewModule"` | ✅/❌ | 0/-5 |
|
|
261
|
-
```
|
|
262
|
-
|
|
263
|
-
##### 检查项2:方法签名一致性
|
|
264
|
-
|
|
265
|
-
- **检查项**: 方法签名一致性
|
|
266
|
-
- **特征检索方式**: 在 `*TurboModule.ets` 中 grep 所有 public 方法声明;在 generated Spec ts 文件中 grep interface 方法签名;在 JS Spec 中 grep 方法签名
|
|
267
|
-
- **检视步骤**:
|
|
268
|
-
1. 从 `*TurboModule.ets` 提取所有 public 方法名及完整签名(参数类型+返回值类型)→列表M
|
|
269
|
-
2. 从 generated Spec ts 文件提取所有 interface 方法签名→列表S
|
|
270
|
-
3. 从 JS Spec 提取所有方法签名→列表J
|
|
271
|
-
4. 逐方法对比 M vs S vs J:方法名相同则对比参数类型、参数顺序、返回值类型是否完全匹配
|
|
272
|
-
5. 判定规则:签名完全一致→通过;任一不匹配→标注不匹配项并扣分
|
|
273
|
-
- **扣分规则**: 签名不匹配→严重-8分/个
|
|
274
|
-
- **输出格式**:
|
|
275
|
-
|
|
276
|
-
```markdown
|
|
277
|
-
| # | 方法名 | ArkTS TurboModule签名 | generated Spec签名 | JS Spec签名 | 签名一致性 | 不匹配详情 | 扣分 |
|
|
278
|
-
|---|--------|----------------------|--------------------|------------|-----------|-----------|------|
|
|
279
|
-
| 1 | `connect` | `(id: string): void` | `(id: string): void` | `(id: string): void` | ✅ | — | 0 |
|
|
280
|
-
| 2 | `readRSSI` | `(id: number): Promise<number>` | `(id: string): Promise<number>` | `(id: string): Promise<number>` | ❌ | ArkTS参数类型number vs string | -8 |
|
|
281
|
-
```
|
|
282
|
-
|
|
283
|
-
##### 检查项3:方法存在性
|
|
284
|
-
|
|
285
|
-
- **检查项**: 方法存在性
|
|
286
|
-
- **特征检索方式**: 在 JS Spec 中提取所有方法名列表;在 `*TurboModule.ets` 中 grep 所有 public 方法名;在文档中搜索不支持标注
|
|
287
|
-
- **检视步骤**:
|
|
288
|
-
1. 从 JS Spec 提取所有方法名→列表J
|
|
289
|
-
2. 从 `*TurboModule.ets` 提取所有 public 方法名→列表A
|
|
290
|
-
3. 对每个 JS Spec 方法名,检查是否存在于列表A中
|
|
291
|
-
4. **🟢 豁免检查(优先级高于扣分)**:对每个 ArkTS 缺失的方法,检查文档是否标注不支持:
|
|
292
|
-
- 查找 **接口规格说明**(如 `接口规格说明.md`),该方法行是否有 `(Android only)`、`(iOS only)`、`(不支持)` 等标注
|
|
293
|
-
- 查找 **OHOS README**(如 `harmony/README.md`),"HarmonyOS Support" 列是否为 "No","Platform" 列是否非 "All" 且非 "HarmonyOS"
|
|
294
|
-
- 查找 **源码注释**,是否有 `// not supported`、`// Android only` 等标注
|
|
295
|
-
5. 判定规则:
|
|
296
|
-
- 🟢 **文档已标注不支持** → 豁免,0分,标注"🟢 文档标注不支持(来源:文件:行号)"
|
|
297
|
-
- ❌ **文档未标注不支持** → 方法缺失→致命-15分/个
|
|
298
|
-
- **扣分规则**: 方法缺失→致命-15分/个;文档标注不支持→豁免0分(不计入致命问题计数)
|
|
299
|
-
- **输出格式**:
|
|
300
|
-
|
|
301
|
-
```markdown
|
|
302
|
-
| # | 方法名 | JS Spec存在 | ArkTS TurboModule存在 | 文档标注不支持 | 文档来源 | 状态 | 扣分 |
|
|
303
|
-
|---|--------|------------|----------------------|--------------|---------|------|------|
|
|
304
|
-
| 1 | `connect` | ✅ | ✅ | — | — | ✅ 方法存在 | 0 |
|
|
305
|
-
| 2 | `clearFormData` | ✅ | ❌ | ✅ Android only, HarmonyOS Support: No | README.md:380 | 🟢 豁免不扣分 | 0 |
|
|
306
|
-
| 3 | `injectJavaScript` | ✅ | ❌ | ❌ 无标注 | — | ❌ 方法缺失 | -15 |
|
|
307
|
-
```
|
|
308
|
-
|
|
309
|
-
##### 检查项4:参数数量
|
|
310
|
-
|
|
311
|
-
- **检查项**: 参数数量
|
|
312
|
-
- **特征检索方式**: 在 JS Spec 中统计每个方法参数数量;在 `*TurboModule.ets` 中统计每个方法参数数量
|
|
313
|
-
- **检视步骤**:
|
|
314
|
-
1. 从 JS Spec 逐方法统计参数数量→映射Q_js
|
|
315
|
-
2. 从 `*TurboModule.ets` 逐方法统计参数数量→映射Q_arkts
|
|
316
|
-
3. 对每个共有方法,对比 Q_js[method] vs Q_arkts[method]
|
|
317
|
-
4. 判定规则:数量一致→通过;不匹配→标注差异并扣分
|
|
318
|
-
- **扣分规则**: 不匹配→致命-8分
|
|
319
|
-
- **输出格式**:
|
|
320
|
-
|
|
321
|
-
```markdown
|
|
322
|
-
| # | 方法名 | JS Spec参数数量 | ArkTS TurboModule参数数量 | 是否一致 | 扣分 |
|
|
323
|
-
|---|--------|---------------|-------------------------|---------|------|
|
|
324
|
-
| 1 | `connect` | 1 | 1 | ✅ | 0 |
|
|
325
|
-
| 2 | `startScan` | 3 | 2 | ❌ | -8 |
|
|
326
|
-
```
|
|
327
|
-
|
|
328
|
-
##### 检查项5:参数类型
|
|
329
|
-
|
|
330
|
-
- **检查项**: 参数类型
|
|
331
|
-
- **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法参数的类型标注;在 JS Spec 中读取对应方法参数类型定义
|
|
332
|
-
- **检视步骤**:
|
|
333
|
-
1. 从 `*TurboModule.ets` 逐方法读取每个参数的类型标注→映射T_arkts
|
|
334
|
-
2. 从 JS Spec 逐方法读取每个参数的类型定义→映射T_js
|
|
335
|
-
3. 对每个共有方法的每个参数,对比 T_arkts[method][param] vs T_js[method][param]
|
|
336
|
-
4. 判定规则:类型完全匹配或为合理的跨平台类型映射(如Double→number)→通过;类型致命错误→标注并扣分
|
|
337
|
-
- **扣分规则**: 类型致命错误→致命-10分/个
|
|
338
|
-
- **输出格式**:
|
|
339
|
-
|
|
340
|
-
```markdown
|
|
341
|
-
| # | 方法名 | 参数位置 | JS Spec类型 | ArkTS TurboModule类型 | 类型一致性 | 扣分 |
|
|
342
|
-
|---|--------|---------|------------|----------------------|-----------|------|
|
|
343
|
-
| 1 | `shouldStartLoadWithLockIdentifier` | 参数1 | `boolean` | `boolean` | ✅ | 0 |
|
|
344
|
-
| 2 | `shouldStartLoadWithLockIdentifier` | 参数2 | `Double` | `number` | ✅(合理映射) | 0 |
|
|
345
|
-
| 3 | `readRSSI` | 参数1 | `string` | `number` | ❌ | -10 |
|
|
346
|
-
```
|
|
347
|
-
|
|
348
|
-
##### 检查项6:参数顺序
|
|
349
|
-
|
|
350
|
-
- **检查项**: 参数顺序
|
|
351
|
-
- **特征检索方式**: 在 JS Spec 中提取每个方法参数定义顺序;在 `*TurboModule.ets` 中提取每个方法参数声明顺序
|
|
352
|
-
- **检视步骤**:
|
|
353
|
-
1. 从 JS Spec 逐方法提取参数定义顺序→映射O_js
|
|
354
|
-
2. 从 `*TurboModule.ets` 逐方法提取参数声明顺序→映射O_arkts
|
|
355
|
-
3. 对每个共有方法,逐参数位置对比 O_js[method][i] vs O_arkts[method][i] 的参数名
|
|
356
|
-
4. 判定规则:同名参数位置完全一致→通过;顺序错误→标注并扣分
|
|
357
|
-
- **扣分规则**: 顺序错误→中等-6分
|
|
358
|
-
- **输出格式**:
|
|
359
|
-
|
|
360
|
-
```markdown
|
|
361
|
-
| # | 方法名 | JS Spec参数顺序 | ArkTS TurboModule参数顺序 | 顺序一致性 | 扣分 |
|
|
362
|
-
|---|--------|----------------|-------------------------|-----------|------|
|
|
363
|
-
| 1 | `connect` | `(id, options)` | `(id, options)` | ✅ | 0 |
|
|
364
|
-
| 2 | `startScan` | `(filter, options, callback)` | `(options, filter, callback)` | ❌ | -6 |
|
|
365
|
-
```
|
|
366
|
-
|
|
367
|
-
#### ②平台实现差异
|
|
368
|
-
|
|
369
|
-
##### 检查项7:方法签名vs Android
|
|
370
|
-
|
|
371
|
-
- **检查项**: 方法签名vs Android
|
|
372
|
-
- **特征检索方式**: 在 Android Java/Kotlin 文件中 grep `@ReactMethod` 注解的方法签名;在 `*TurboModule.ets` 中 grep public 方法签名
|
|
373
|
-
- **检视步骤**:
|
|
374
|
-
1. 从 `*TurboModule.ets` 提取所有方法签名→列表M
|
|
375
|
-
2. 从 Android Java/Kotlin TurboModule 文件中读取所有 `@ReactMethod` 标注的方法签名→列表A_android
|
|
376
|
-
3. 对每个共有方法,对比 M[method] vs A_android[method] 的参数数量、参数类型、返回值类型
|
|
377
|
-
4. 判定规则:差异项合并至①契约一致性检查,不独立扣分;Android签名差异视为JS Spec签名差异的补充参考
|
|
378
|
-
- **扣分规则**: 差异合并至①检查,不独立扣分
|
|
379
|
-
- **输出格式**:
|
|
380
|
-
|
|
381
|
-
```markdown
|
|
382
|
-
| # | 方法名 | ArkTS TurboModule签名 | Android @ReactMethod签名 | 差异 | 合并至①检查项 |
|
|
383
|
-
|---|--------|----------------------|------------------------|------|-------------|
|
|
384
|
-
| 1 | `connect` | `(id: string): void` | `(String id): void` | ✅ 功能一致 | — |
|
|
385
|
-
| 2 | `requestPriority` | `(priority: number): void` | `(int priority): void` | ✅ 合理映射 | — |
|
|
386
|
-
```
|
|
387
|
-
|
|
388
|
-
##### 检查项8:方法签名vs iOS
|
|
389
|
-
|
|
390
|
-
- **检查项**: 方法签名vs iOS
|
|
391
|
-
- **特征检索方式**: 在 iOS 文件中 grep `RCT_EXPORT_METHOD` 宏定义的方法签名;在 `*TurboModule.ets` 中 grep public 方法签名
|
|
392
|
-
- **检视步骤**:
|
|
393
|
-
1. 从 `*TurboModule.ets` 提取所有方法签名→列表M
|
|
394
|
-
2. 从 iOS TurboModule 文件中读取所有 `RCT_EXPORT_METHOD` 定义的签名→列表A_ios
|
|
395
|
-
3. 对每个共有方法,对比 M[method] vs A_ios[method] 的参数数量、参数类型、返回值类型
|
|
396
|
-
4. 判定规则:差异项合并至①契约一致性检查,不独立扣分;iOS签名差异视为JS Spec签名差异的补充参考
|
|
397
|
-
- **扣分规则**: 差异合并至①检查,不独立扣分
|
|
398
|
-
- **输出格式**:
|
|
399
|
-
|
|
400
|
-
```markdown
|
|
401
|
-
| # | 方法名 | ArkTS TurboModule签名 | iOS RCT_EXPORT_METHOD签名 | 差异 | 合并至①检查项 |
|
|
402
|
-
|---|--------|----------------------|--------------------------|------|-------------|
|
|
403
|
-
| 1 | `connect` | `(id: string): void` | `(NSString *id)` | ✅ 功能一致 | — |
|
|
404
|
-
| 2 | `readRSSI` | `(id: number): Promise<number>` | `(NSString *deviceID)` | 参数名差异 | 参考① |
|
|
405
|
-
```
|
|
406
|
-
|
|
407
|
-
#### ③架构桥接一致性
|
|
408
|
-
|
|
409
|
-
##### 检查项9:Spec接口实现
|
|
410
|
-
|
|
411
|
-
- **检查项**: Spec接口实现
|
|
412
|
-
- **特征检索方式**: 在 `*TurboModule.ets` 中 grep `implements TM.Xxx.Spec` 或类声明中的 implements 关系
|
|
413
|
-
- **检视步骤**:
|
|
414
|
-
1. 读取 `*TurboModule.ets` 中 TurboModule 类声明行
|
|
415
|
-
2. 检查类声明是否包含 `implements TM.Xxx.Spec`(Codegen模式)或手写 Spec 接口(Legacy模式)
|
|
416
|
-
3. 判定规则:实现了 generated Spec 接口→通过;未实现→标注并扣分
|
|
417
|
-
- **扣分规则**: 未实现→严重-8分/个
|
|
418
|
-
- **输出格式**:
|
|
419
|
-
|
|
420
|
-
```markdown
|
|
421
|
-
| # | TurboModule名 | ArkTS类声明 | implements Spec? | Spec接口来源 | 状态 | 扣分 |
|
|
422
|
-
|---|--------------|------------|-----------------|------------|------|------|
|
|
423
|
-
| 1 | `RNCWebViewModule` | `class WebViewTurboModule extends AnyThreadTurboModule implements TM.RNCWebViewModule.Spec` | ✅ | generated Codegen | ✅ 已实现 | 0 |
|
|
424
|
-
| 2 | `BleManagerModule` | `class BleTurboModule extends TurboModule` | ❌ | — | ❌ 未实现 | -8 |
|
|
425
|
-
```
|
|
426
|
-
|
|
427
|
-
---
|
|
428
|
-
|
|
429
|
-
### 3.2 检查点:返回值
|
|
430
|
-
|
|
431
|
-
#### 检查项概要
|
|
432
|
-
|
|
433
|
-
| # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
|
|
434
|
-
|---|--------|------|----------|----------|--------|
|
|
435
|
-
| 1 | 返回值类型 | ①契约一致性 | ArkTS TurboModule返回值 vs JS Spec期望返回值 | 返回值类型错误→-10分/个 | 致命 |
|
|
436
|
-
| 2 | 返回值语义 | ①契约一致性 | ArkTS TurboModule返回内容 vs JS Spec接口语义 | 语义不匹配→视严重度扣分 | 严重/中等 |
|
|
437
|
-
| 3 | Promise处理 | ①契约一致性 | ArkTS TurboModule异步方法返回值 vs JS Spec异步声明 | Promise未正确包裹→-8分/个 | 严重 |
|
|
438
|
-
| 4 | 常量导出完整性 | ①契约一致性 | ArkTS TurboModule getConstants() vs Android/iOS getConstants() | 失常量→-5分/个 | 中等 |
|
|
439
|
-
| 5 | 常量值一致性 | ①契约一致性 | 各平台导出的常量值 | 值不一致→-3分/个 | 轻微 |
|
|
440
|
-
| 6 | 返回值vs Android/iOS | ②平台实现差异 | ArkTS TurboModule方法返回值 vs Android/iOS方法返回值 | 合并至①检查 | — |
|
|
441
|
-
| — | ③架构桥接一致性 | — | 已由①覆盖 | — | — |
|
|
442
|
-
|
|
443
|
-
#### ①契约一致性
|
|
444
|
-
|
|
445
|
-
##### 检查项1:返回值类型
|
|
446
|
-
|
|
447
|
-
- **检查项**: 返回值类型
|
|
448
|
-
- **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法的返回值类型标注;在 JS Spec 中读取对应方法的期望返回值类型
|
|
449
|
-
- **检视步骤**:
|
|
450
|
-
1. 从 `*TurboModule.ets` 逐方法读取返回值类型标注→映射R_arkts
|
|
451
|
-
2. 从 JS Spec 逐方法读取期望返回值类型→映射R_js
|
|
452
|
-
3. 对每个共有方法,对比 R_arkts[method] vs R_js[method]
|
|
453
|
-
4. 判定规则:类型完全匹配或为合理跨平台映射→通过;返回值类型错误→标注并扣分
|
|
454
|
-
- **扣分规则**: 返回值类型错误→致命-10分/个
|
|
455
|
-
- **输出格式**:
|
|
456
|
-
|
|
457
|
-
```markdown
|
|
458
|
-
| # | 方法名 | JS Spec期望返回值类型 | ArkTS TurboModule返回值类型 | 类型一致性 | 扣分 |
|
|
459
|
-
|---|--------|--------------------|--------------------------|-----------|------|
|
|
460
|
-
| 1 | `isFileUploadSupported` | `Promise<boolean>` | `Promise<boolean>` | ✅ | 0 |
|
|
461
|
-
| 2 | `connect` | `void` | `Promise<void>` | ❌(多包裹Promise) | -10 |
|
|
462
|
-
```
|
|
463
|
-
|
|
464
|
-
##### 检查项2:返回值语义
|
|
465
|
-
|
|
466
|
-
- **检查项**: 返回值语义
|
|
467
|
-
- **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法的方法体,验证返回值的语义正确性;在 JS Spec 中读取接口语义描述
|
|
468
|
-
- **检视步骤**:
|
|
469
|
-
1. 读取 `*TurboModule.ets` 中每个方法的方法体,分析返回内容是否符合接口语义
|
|
470
|
-
2. 读取 JS Spec 中对应方法的语义描述(方法名、注释、类型语义)
|
|
471
|
-
3. 对比 ArkTS 实际返回值语义是否与 JS Spec 接口语义一致
|
|
472
|
-
4. 判定规则:语义一致→通过;语义不匹配→视严重度扣分
|
|
473
|
-
- **扣分规则**: 语义严重不匹配→严重扣分;轻微语义偏差→中等扣分
|
|
474
|
-
- **输出格式**:
|
|
475
|
-
|
|
476
|
-
```markdown
|
|
477
|
-
| # | 方法名 | JS Spec接口语义 | ArkTS TurboModule返回语义 | 语义一致性 | 扣分 |
|
|
478
|
-
|---|--------|---------------|--------------------------|-----------|------|
|
|
479
|
-
| 1 | `isFileUploadSupported` | 返回当前设备是否支持文件上传 | 固定返回true(语义:始终支持) | ✅ | 0 |
|
|
480
|
-
| 2 | `getOpenPeripherals` | 返回已连接的外围设备列表 | 返回空数组[](语义:无设备) | ❌ | -5 |
|
|
481
|
-
```
|
|
482
|
-
|
|
483
|
-
##### 检查项3:Promise处理
|
|
484
|
-
|
|
485
|
-
- **检查项**: Promise处理
|
|
486
|
-
- **特征检索方式**: 在 JS Spec 中 grep `Promise<` 或标注为异步的方法;在 `*TurboModule.ets` 中 grep `Promise<` 或 `async` 关键字
|
|
487
|
-
- **检视步骤**:
|
|
488
|
-
1. 从 `*TurboModule.ets` 检查每个方法是否返回 Promise→映射P_arkts
|
|
489
|
-
2. 从 JS Spec 检查哪些方法声明为异步(返回值类型含 Promise)→映射P_js
|
|
490
|
-
3. 对每个共有方法,对比 P_arkts[method] vs P_js[method]
|
|
491
|
-
4. 验证 ArkTS 异步方法是否正确使用 `Promise.resolve()`/`Promise.reject()` 包裹返回值
|
|
492
|
-
5. 判定规则:JS Spec异步方法在ArkTS也返回Promise且包裹正确→通过;异步未包裹Promise→标注并扣分
|
|
493
|
-
- **扣分规则**: Promise未正确包裹→严重-8分/个
|
|
494
|
-
- **输出格式**:
|
|
495
|
-
|
|
496
|
-
```markdown
|
|
497
|
-
| # | 方法名 | JS Spec是否异步 | ArkTS TurboModule是否返回Promise | Promise包裹正确性 | 扣分 |
|
|
498
|
-
|---|--------|---------------|-------------------------------|-----------------|------|
|
|
499
|
-
| 1 | `isFileUploadSupported` | ✅ Promise<boolean> | ✅ Promise.resolve(true) | ✅ | 0 |
|
|
500
|
-
| 2 | `readRSSI` | ✅ Promise<number> | ❌ 直接返回number | ❌ | -8 |
|
|
501
|
-
```
|
|
502
|
-
|
|
503
|
-
##### 检查项4:常量导出完整性
|
|
504
|
-
|
|
505
|
-
- **检查项**: 常量导出完整性
|
|
506
|
-
- **特征检索方式**: 在 `*TurboModule.ets` 中 grep `getConstants()` 方法;在 Android Java 中 grep `getConstants()` 方法;在 iOS 中 grep `getConstants()` 或常量导出相关代码
|
|
507
|
-
- **检视步骤**:
|
|
508
|
-
1. 从 `*TurboModule.ets` 读取 `getConstants()` 方法,提取所有常量名→列表O
|
|
509
|
-
2. 从 Android Java TurboModule 文件读取 `getConstants()` 方法,提取所有常量名→列表A
|
|
510
|
-
3. 从 iOS TurboModule 文件读取常量导出代码,提取所有常量名→列表I
|
|
511
|
-
4. 对比 O vs A vs I:检查每个常量是否在三平台均有导出
|
|
512
|
-
5. 判定规则:三平台均导出→通过;任一平台失常量→标注并扣分
|
|
513
|
-
- **扣分规则**: 失常量→中等-5分/个
|
|
514
|
-
- **输出格式**:
|
|
515
|
-
|
|
516
|
-
```markdown
|
|
517
|
-
| # | 常量名 | Android导出 | iOS导出 | ArkTS TurboModule导出 | ArkTS文件:行号 | 完整性 | 扣分 |
|
|
518
|
-
|---|--------|-----------|---------|----------------------|---------------|--------|------|
|
|
519
|
-
| 1 | `Scale` | ✅ | ✅ | ✅ | `MapsTurboModule.ets:25` | ✅ 三平台一致 | 0 |
|
|
520
|
-
| 2 | `ConnectionPriority` | ✅ | ⛔ 无 | ⛔ 无 | — | ⚠️ 仅Android有 | -5 |
|
|
521
|
-
```
|
|
522
|
-
|
|
523
|
-
##### 检查项5:常量值一致性
|
|
524
|
-
|
|
525
|
-
- **检查项**: 常量值一致性
|
|
526
|
-
- **特征检索方式**: 在各平台 TurboModule 文件中读取 `getConstants()` 返回的常量值
|
|
527
|
-
- **检视步骤**:
|
|
528
|
-
1. 从各平台 `getConstants()` 方法中提取常量的具体值
|
|
529
|
-
2. 对每个共有常量,对比 Android值 vs iOS值 vs ArkTS TurboModule值
|
|
530
|
-
3. 判定规则:值完全一致→通过;值不一致→标注差异并扣分
|
|
531
|
-
- **扣分规则**: 值不一致→轻微-3分/个
|
|
532
|
-
- **输出格式**:
|
|
533
|
-
|
|
534
|
-
```markdown
|
|
535
|
-
| # | 常量名 | Android值 | iOS值 | ArkTS TurboModule值 | 值一致性 | 扣分 |
|
|
536
|
-
|---|--------|---------|-------|--------------------|---------|------|
|
|
537
|
-
| 1 | `Scale` | `0.0001` | `0.0001` | `0.0001` | ✅ | 0 |
|
|
538
|
-
| 2 | `Timeout` | `30` | `30` | `60` | ❌ | -3 |
|
|
539
|
-
```
|
|
540
|
-
|
|
541
|
-
#### ②平台实现差异
|
|
542
|
-
|
|
543
|
-
##### 检查项6:返回值vs Android/iOS
|
|
544
|
-
|
|
545
|
-
- **检查项**: 返回值vs Android/iOS
|
|
546
|
-
- **特征检索方式**: 在 Android/iOS TurboModule 文件中读取方法返回值;在 `*TurboModule.ets` 中读取方法返回值
|
|
547
|
-
- **检视步骤**:
|
|
548
|
-
1. 从 `*TurboModule.ets` 提取每个方法的返回值类型和语义
|
|
549
|
-
2. 从 Android/iOS TurboModule 提取对应方法的返回值类型和语义
|
|
550
|
-
3. 对比 ArkTS返回值 vs Android/iOS返回值
|
|
551
|
-
4. 判定规则:差异合并至①契约一致性检查,不独立扣分;Android/iOS返回值差异视为JS Spec返回值对比的补充参考
|
|
552
|
-
- **扣分规则**: 差异合并至①检查,不独立扣分
|
|
553
|
-
- **输出格式**:
|
|
554
|
-
|
|
555
|
-
```markdown
|
|
556
|
-
| # | 方法名 | ArkTS TurboModule返回值 | Android返回值 | iOS返回值 | 差异 | 合并至①检查项 |
|
|
557
|
-
|---|--------|------------------------|-------------|---------|------|-------------|
|
|
558
|
-
| 1 | `isFileUploadSupported` | `Promise<boolean>` | `boolean` | `BOOL` | ✅ 功能一致 | — |
|
|
559
|
-
```
|
|
560
|
-
|
|
561
|
-
#### ③架构桥接一致性
|
|
562
|
-
|
|
563
|
-
> ③架构桥接一致性维度已由①契约一致性检查覆盖(Spec接口实现已在3.1检查点9中完成),此处不再重复。
|
|
564
|
-
|
|
565
|
-
---
|
|
566
|
-
|
|
567
|
-
### 3.3 检查点:实现逻辑 ⚠️ 最关键检查项
|
|
568
|
-
|
|
569
|
-
#### 检查项概要
|
|
570
|
-
|
|
571
|
-
| # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
|
|
572
|
-
|---|--------|------|----------|----------|--------|
|
|
573
|
-
| 1 | Stub检测与合理性判定 | ②平台实现差异⚠️核心 | ArkTS方法实现 vs Android/iOS同名方法行为 | 致命Stub→-8分/方法;空方法体→-8分/方法;逻辑Stub→-12分/方法;合理Stub→0分 | 致命/严重/0 |
|
|
574
|
-
| 2 | 方法行为跨平台对比 | ②平台实现差异⚠️核心 | Android/iOS/OHOS三平台方法行为 | 行为致命不一致→-15分/方法;行为严重不一致→-12分/方法 | 致命/严重 |
|
|
575
|
-
| 3 | 边界处理 | ②平台实现差异 | ArkTS方法边界条件 vs Android/iOS边界处理 | 不一致→-8分 | 中等 |
|
|
576
|
-
| 4 | 错误处理 | ②平台实现差异 | ArkTS方法错误处理 vs Android/iOS错误处理 | 不一致→-6分 | 中等 |
|
|
577
|
-
| 5 | 回调/事件机制 | ③架构桥接一致性 | ArkTS回调触发逻辑 vs Android/iOS回调触发逻辑 | 触发逻辑不一致→-12分/个 | 严重 |
|
|
578
|
-
| — | ①契约一致性 | — | 实现逻辑不属于契约维度,N/A | — | — |
|
|
579
|
-
|
|
580
|
-
#### ①契约一致性
|
|
581
|
-
|
|
582
|
-
> 实现逻辑不属于契约维度(契约维度仅覆盖签名和返回值声明),①为 N/A。
|
|
583
|
-
|
|
584
|
-
#### ②平台实现差异 ⚠️ 核心维度:每个方法与Android/iOS行为级对比
|
|
585
|
-
|
|
586
|
-
##### 检查项1:Stub检测与合理性判定
|
|
587
|
-
|
|
588
|
-
- **检查项**: Stub检测与合理性判定
|
|
589
|
-
- **特征检索方式**: 在 `*TurboModule.ets` 中查找以下Stub模式:(a) `return true;` / `return false;` / `return null;` 等固定返回值;(b) `return Promise.resolve(true)` / `return Promise.resolve(false)` 等固定Promise返回;(c) 方法体仅有 `console.log` 或注释;(d) 方法体为空或仅有 `{}`;(e) 未调用任何 `@ohos` API 或实际业务操作
|
|
590
|
-
- **检视步骤**:
|
|
591
|
-
1. 读取 `*TurboModule.ets` 中每个方法的方法体
|
|
592
|
-
2. 识别Stub模式:(a) 方法体仅有return固定值;(b) 未调用@ohos API;(c) 未执行实际业务操作;(d) 仅console.log输出
|
|
593
|
-
3. 读取 Android Java/Kotlin TurboModule 中同名方法的实际实现
|
|
594
|
-
4. 读取 iOS TurboModule 中同名方法的实际实现
|
|
595
|
-
5. 对比:Android/iOS有实际业务逻辑但ArkTS为Stub→致命Stub;iOS也返回固定值→合理Stub
|
|
596
|
-
6. 判定规则:三平台行为一致(均为固定返回)→合理Stub 0分;Android/iOS有实际逻辑但ArkTS为Stub→致命Stub 扣分
|
|
597
|
-
- **扣分规则**:
|
|
598
|
-
- 合理固定返回:方法语义本身返回固定值且与Android/iOS一致→0分
|
|
599
|
-
- 无条件Stub:返回固定值但Android/iOS有实际业务逻辑→致命-8分/方法
|
|
600
|
-
- 空方法体Stub:方法体为空或仅有console.log→致命-8分/方法
|
|
601
|
-
- 逻辑Stub:有部分逻辑但缺少核心操作→严重-12分/方法
|
|
602
|
-
- **输出格式**:
|
|
603
|
-
|
|
604
|
-
```markdown
|
|
605
|
-
| # | 方法名 | ArkTS文件:行号 | Stub代码片段 | Stub类型 | Android实现 | iOS实现 | Stub合理性 | 缺失逻辑 | 严重度 | 扣分 |
|
|
606
|
-
|---|--------|---------------|-------------|---------|------------|--------|-----------|---------|--------|------|
|
|
607
|
-
| 1 | `isFileUploadSupported` | `WebViewTurboModule.ets:14` | `return Promise.resolve(true)` | 合理固定返回 | ✅ Android5+返回true | ✅ 始终返回YES | ✅ 三平台一致 | 无 | ⚠️ 合理 | 0 |
|
|
608
|
-
| 2 | `removeBond` | `BleTurboModule.ets:278` | `return true;` | 无条件Stub | ✅ 调用BluetoothDevice.removeBond() | ✅ 调用CBCentralManager.remove() | ❌ 缺失实际解绑 | 实际解绑操作 | ❌ 致命 | -8 |
|
|
609
|
-
| 3 | `requestPriority` | `BleTurboModule.ets:455` | `// todo: implement` | 空方法体Stub | ✅ 调用gatt.requestConnectionPriority() | ⛔ 不支持 | ❌ 空方法体 | 优先级请求 | ❌ 致命 | -8 |
|
|
610
|
-
| 4 | `connect` | `BleTurboModule.ets:89` | 仅更新状态变量未调用蓝牙连接 | 逻辑Stub | ✅ 调用BluetoothGatt.connect() | ✅ 调用CBCentralManager.connect() | ❌ 缺少核心操作 | 蓝牙连接API调用 | ❌ 严重 | -12 |
|
|
611
|
-
```
|
|
612
|
-
|
|
613
|
-
##### 检查项2:方法行为跨平台对比
|
|
614
|
-
|
|
615
|
-
- **检查项**: 方法行为跨平台对比
|
|
616
|
-
- **特征检索方式**: 在 Android/iOS/ArkTS 三平台 TurboModule 文件中读取每个方法的实现摘要
|
|
617
|
-
- **检视步骤**:
|
|
618
|
-
1. 对每个TurboModule方法,读取Android实现并提取行为摘要(调用的API、执行的操作、产生的结果)
|
|
619
|
-
2. 读取iOS实现并提取行为摘要
|
|
620
|
-
3. 读取ArkTS TurboModule实现并提取行为摘要
|
|
621
|
-
4. 对比三平台实际行为:核心业务逻辑是否一致、副作用是否一致、结果是否等效
|
|
622
|
-
5. 判定规则:三平台行为一致或功能等效→通过;行为致命不一致→致命扣分;行为严重不一致→严重扣分
|
|
623
|
-
- **扣分规则**:
|
|
624
|
-
- 行为致命不一致(核心功能缺失或行为完全不同)→致命-15分/方法
|
|
625
|
-
- 行为严重不一致(部分核心逻辑缺失)→严重-12分/方法
|
|
626
|
-
- **输出格式**:
|
|
627
|
-
|
|
628
|
-
```markdown
|
|
629
|
-
| # | 方法名 | Android实现摘要 | iOS实现摘要 | ArkTS实现摘要 | ArkTS文件:行号 | 行为对比状态 | 扣分 |
|
|
630
|
-
|---|--------|---------------|------------|--------------|---------------|------------|------|
|
|
631
|
-
| 1 | `isFileUploadSupported` | ✅ Android5+返回true | ✅ 始终返回YES | ✅ 始终返回true | `WebViewTurboModule.ets:14` | ✅ 三平台一致 | 0 |
|
|
632
|
-
| 2 | `connect` | ✅ 调用BluetoothGatt.connect() | ✅ 调用CBCentralManager.connect() | ✅ 调用@ohos.bluetooth.ble.connect() | `BleTurboModule.ets:89` | ✅ 功能一致 | 0 |
|
|
633
|
-
| 3 | `removeBond` | ✅ 调用BluetoothDevice.removeBond() | ✅ 调用CBCentralManager.remove() | ❌ Stub: return true | `BleTurboModule.ets:278` | ❌ 致命不一致 | -15 |
|
|
634
|
-
```
|
|
635
|
-
|
|
636
|
-
##### 检查项3:边界处理
|
|
637
|
-
|
|
638
|
-
- **检查项**: 边界处理
|
|
639
|
-
- **特征检索方式**: 在 `*TurboModule.ets` 中查找边界条件处理代码(null/undefined检查、空数组检查、越界检查等);在 Android/iOS TurboModule 中查找同名方法的边界条件处理
|
|
640
|
-
- **检视步骤**:
|
|
641
|
-
1. 从 `*TurboModule.ets` 读取每个方法的边界条件处理(null检查、空值检查、参数校验等)
|
|
642
|
-
2. 从 Android/iOS TurboModule 读取同名方法的边界条件处理
|
|
643
|
-
3. 对比 ArkTS边界处理 vs Android/iOS边界处理
|
|
644
|
-
4. 判定规则:边界处理一致或ArkTS有更严格的处理→通过;不一致→标注并扣分
|
|
645
|
-
- **扣分规则**: 不一致→中等-8分
|
|
646
|
-
- **输出格式**:
|
|
647
|
-
|
|
648
|
-
```markdown
|
|
649
|
-
| # | 方法名 | Android/iOS边界处理 | ArkTS TurboModule边界处理 | 一致性 | 扣分 |
|
|
650
|
-
|---|--------|-------------------|-------------------------|--------|------|
|
|
651
|
-
| 1 | `connect` | ✅ 检查id非null | ✅ 检查id非null和非空字符串 | ✅ ArkTS更严格 | 0 |
|
|
652
|
-
| 2 | `startScan` | ✅ 检查filter非null | ❌ 无边界检查 | ❌ | -8 |
|
|
653
|
-
```
|
|
654
|
-
|
|
655
|
-
##### 检查项4:错误处理
|
|
656
|
-
|
|
657
|
-
- **检查项**: 错误处理
|
|
658
|
-
- **特征检索方式**: 在 `*TurboModule.ets` 中查找 try-catch 块、error回调、Promise.reject 等错误处理模式;在 Android/iOS TurboModule 中查找同名方法的错误处理
|
|
659
|
-
- **检视步骤**:
|
|
660
|
-
1. 从 `*TurboModule.ets` 读取每个方法的错误处理(try-catch、error callback、Promise.reject等)
|
|
661
|
-
2. 从 Android/iOS TurboModule 读取同名方法的错误处理
|
|
662
|
-
3. 对比 ArkTS错误处理 vs Android/iOS错误处理
|
|
663
|
-
4. 判定规则:错误处理一致或ArkTS有合理的错误处理→通过;不一致→标注并扣分
|
|
664
|
-
- **扣分规则**: 不一致→中等-6分
|
|
665
|
-
- **输出格式**:
|
|
666
|
-
|
|
667
|
-
```markdown
|
|
668
|
-
| # | 方法名 | Android/iOS错误处理 | ArkTS TurboModule错误处理 | 一致性 | 扣分 |
|
|
669
|
-
|---|--------|-------------------|-------------------------|--------|------|
|
|
670
|
-
| 1 | `connect` | ✅ try-catch + Promise.reject | ✅ try-catch + Promise.reject | ✅ | 0 |
|
|
671
|
-
| 2 | `readRSSI` | ✅ try-catch + 回调error参数 | ❌ 无错误处理 | ❌ | -6 |
|
|
672
|
-
```
|
|
673
|
-
|
|
674
|
-
#### ③架构桥接一致性
|
|
675
|
-
|
|
676
|
-
##### 检查项5:回调/事件机制
|
|
677
|
-
|
|
678
|
-
- **检查项**: 回调/事件机制
|
|
679
|
-
- **特征检索方式**: 在 `*TurboModule.ets` 中 grep 回调调用模式(`this.emitDeviceEvent`、`sendEvent`、回调函数调用);在 Android/iOS TurboModule 中 grep 同名回调触发模式(Android: `sendEvent`/回调接口;iOS: `RCTEventEmitter`/block回调)
|
|
680
|
-
- **检视步骤**:
|
|
681
|
-
1. 从 `*TurboModule.ets` 读取每个回调方法的触发逻辑(触发时机、触发方式、回调参数)
|
|
682
|
-
2. 从 Android TurboModule 读取同名回调/事件的触发逻辑
|
|
683
|
-
3. 从 iOS TurboModule 读取同名回调/事件的触发逻辑
|
|
684
|
-
4. 对比 ArkTS回调触发逻辑 vs Android/iOS回调触发逻辑
|
|
685
|
-
5. 判定规则:触发时机、触发方式、回调参数三平台一致→通过;触发逻辑不一致→标注并扣分
|
|
686
|
-
- **扣分规则**: 触发逻辑不一致→严重-12分/个
|
|
687
|
-
- **输出格式**:
|
|
688
|
-
|
|
689
|
-
```markdown
|
|
690
|
-
| # | 回调/事件名 | JS Spec定义 | Android触发逻辑 | iOS触发逻辑 | ArkTS TurboModule触发逻辑 | ArkTS文件:行号 | 触发逻辑一致性 | 扣分 |
|
|
691
|
-
|---|------------|-------------|---------------|------------|-------------------------|---------------|--------------|------|
|
|
692
|
-
| 1 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | ✅ AtomicReference + notify | ✅ DecisionManager setResult | ✅ ShouldStartParams + lockState | `WebViewTurboModule.ets:18` | ✅ 功能一致 | 0 |
|
|
693
|
-
| 2 | `onBluetoothStateChange` | `event: {state: string}` | ✅ sendEvent("onBluetoothStateChange", {state}) | ✅ RCTEventEmitter | ⛔ 未发送事件 | — | ❌ 事件缺失 | -12 |
|
|
694
|
-
```
|
|
695
|
-
|
|
696
|
-
---
|
|
697
|
-
|
|
698
|
-
## 4. 方法行为跨平台对比
|
|
699
|
-
|
|
700
|
-
### 4.1 方法行为对比格式
|
|
701
|
-
|
|
702
|
-
对每个 TurboModule 方法,必须与 Android/iOS 的同名方法做行为对比:
|
|
703
|
-
|
|
704
|
-
```markdown
|
|
705
|
-
| # | 方法名 | Android 实现摘要 | iOS 实现摘要 | ArkTS TurboModule 实现摘要 | ArkTS 文件:行号 | 行为对比状态 | 扣分 |
|
|
706
|
-
|---|--------|----------------|-------------|--------------------------|---------------|------------|------|
|
|
707
|
-
| 1 | `isFileUploadSupported` | ✅ Android 5+ 返回 true | ✅ 始终返回 YES | ✅ 始终返回 true | `WebViewTurboModule.ets:14` | ✅ 三平台一致 | 0 |
|
|
708
|
-
| 2 | `connect` | ✅ 调用 BluetoothGatt.connect() | ✅ 调用 CBCentralManager.connect() | ✅ 调用 @ohos.bluetooth.ble.connect() | `BleTurboModule.ets:89` | ✅ 功能一致 | 0 |
|
|
709
|
-
| 3 | `removeBond` | ✅ 调用 BluetoothDevice.removeBond() | ✅ 调用 CBCentralManager.remove() | ❌ Stub: `return true;` | `BleTurboModule.ets:278` | ❌ 致命不一致 | -8 |
|
|
710
|
-
```
|
|
711
|
-
|
|
712
|
-
### 4.2 行为一致性判定规则
|
|
713
|
-
|
|
714
|
-
| 行为对比结果 | 判定 | 扣分 |
|
|
715
|
-
|-------------|------|------|
|
|
716
|
-
| 三平台行为一致 | ✅ 一致 | 0 |
|
|
717
|
-
| OHOS 使用不同机制但功能等效 | ✅ 功能一致 | 0 |
|
|
718
|
-
| OHOS 仅缺少非核心差异 | ⚠️ 轻微不一致 | -3~-5 |
|
|
719
|
-
| OHOS 缺少部分核心逻辑 | ❌ 严重不一致 | -8~-12 |
|
|
720
|
-
| OHOS 为 Stub 或方法缺失 | ❌ 致命 | -8~-15 |
|
|
721
|
-
|
|
722
|
-
---
|
|
723
|
-
|
|
724
|
-
## 5. 跨层一致性检测(ArkTS TurboModule 视角)
|
|
725
|
-
|
|
726
|
-
### 5.1 全链路 TurboModule 对比
|
|
727
|
-
|
|
728
|
-
```markdown
|
|
729
|
-
| # | TurboModule 名 | JS Spec 定义 | JS Spec 注册名 | C++ FactoryDelegate 注册名 | C++ JSIBinder | generated Spec 接口 | ArkTS TurboModule 类 | ArkTS 文件 | 状态 | 扣分 |
|
|
730
|
-
|---|--------------|------------|--------------|------------------------|-------------|--------------------|--------------------|-----------|------|------|
|
|
731
|
-
| 1 | `RNCWebViewModule` | `NativeRNCWebViewModule.ts` | `RNCWebViewModule` | ✅ `RNCWebViewModule` | ✅ JSIBinder | ✅ TM.RNCWebViewModule.Spec | ✅ WebViewTurboModule | `WebViewTurboModule.ets:11` | ✅ 全链路一致 | 0 |
|
|
732
|
-
```
|
|
733
|
-
|
|
734
|
-
### 5.2 断桥类型定义(TurboModule 视角)
|
|
735
|
-
|
|
736
|
-
| 断桥位置 | 识别方式 | 影响 | 扣分 |
|
|
737
|
-
|---------|----------|------|------|
|
|
738
|
-
| JS→C++ 注册断桥 | JS Spec TurboModuleRegistry 注册名在 C++ FactoryDelegate 中无对应 if 条件 | JS 调用 TurboModule 但 C++ 无法创建实例 | -10/个(致命) |
|
|
739
|
-
| C++→ArkTS 类映射断桥 | C++ FactoryDelegate 中 `std::make_shared<XxxTurboModule>` 类名在 ArkTS 中无对应实现类 | C++ 创建实例但无法路由到 ArkTS 实现 | -8/个(严重) |
|
|
740
|
-
| ArkTS 方法缺失断桥 | JS Spec 方法在 ArkTS TurboModule 中无对应方法实现 | JS 调用方法但 ArkTS 不响应 | -15/个(致命) |
|
|
741
|
-
| ArkTS Stub 断桥 | ArkTS TurboModule 方法为 Stub 但 Android/iOS 有实际业务逻辑 | 方法调用成功但行为完全不同 | -8/方法(致命) |
|
|
742
|
-
| ArkTS 常量缺失断桥 | Android/iOS getConstants() 导出的常量在 ArkTS TurboModule 中缺失 | JS 读取常量返回 undefined | -5/个(中等) |
|
|
743
|
-
|
|
744
|
-
---
|
|
745
|
-
|
|
746
|
-
## 6. 检视操作流程
|
|
747
|
-
|
|
748
|
-
### 6.1 Phase 0 补充步骤(ArkTS TurboModule 定位)
|
|
749
|
-
|
|
750
|
-
```
|
|
751
|
-
TM-ARK-1: 定位 ArkTS TurboModule 实现文件
|
|
752
|
-
→ 搜索 harmony/<module>/src/main/ets/*TurboModule.ets
|
|
753
|
-
|
|
754
|
-
TM-ARK-2: 定位 generated TurboModule Spec 类型
|
|
755
|
-
→ 搜索 generated/turboModules/TurboModuleName.ts
|
|
756
|
-
→ 搜索 generated/turboModules/ts.ts
|
|
757
|
-
|
|
758
|
-
TM-ARK-3: 读取 ArkTS TurboModule 类声明
|
|
759
|
-
→ 提取 NAME 常量、父类、implements Spec 接口
|
|
760
|
-
|
|
761
|
-
TM-ARK-4: 读取 generated Spec 接口方法列表
|
|
762
|
-
→ 提取所有方法名和签名
|
|
763
|
-
```
|
|
764
|
-
|
|
765
|
-
### 6.2 Phase 3 补充步骤(ArkTS TurboModule 分析)
|
|
766
|
-
|
|
767
|
-
```
|
|
768
|
-
TM-ARK-5: TurboModule NAME 常量对比
|
|
769
|
-
→ ArkTS NAME 常量 vs JS Spec TurboModuleRegistry 注册名 vs C++ FactoryDelegate 注册名
|
|
770
|
-
→ 标注注册名不一致
|
|
771
|
-
|
|
772
|
-
TM-ARK-6: 方法实现完整性对比
|
|
773
|
-
→ JS Spec 方法名 vs generated Spec 方法名 vs ArkTS TurboModule 方法名
|
|
774
|
-
→ 标注方法缺失
|
|
775
|
-
|
|
776
|
-
TM-ARK-7: 方法签名对比
|
|
777
|
-
→ ArkTS TurboModule 方法签名 vs generated Spec 接口方法签名
|
|
778
|
-
→ 标注签名不匹配、类型映射错误
|
|
779
|
-
|
|
780
|
-
TM-ARK-8: Stub 检测与合理性判定
|
|
781
|
-
→ 对每个 ArkTS TurboModule 方法判断是否为 Stub
|
|
782
|
-
→ 与 Android/iOS 同名方法行为对比判定 Stub 合理性
|
|
783
|
-
→ 标注 Stub 方法及其缺失逻辑
|
|
784
|
-
|
|
785
|
-
TM-ARK-9: 常量导出对比
|
|
786
|
-
→ Android/iOS getConstants() vs ArkTS TurboModule getConstants()
|
|
787
|
-
→ 标注失常量
|
|
788
|
-
|
|
789
|
-
TM-ARK-10: 回调/事件对比
|
|
790
|
-
→ ArkTS TurboModule 回调/事件实现 vs Android/iOS 回调/事件
|
|
791
|
-
→ 标注回调缺失、事件缺失、Payload 缺失
|
|
792
|
-
|
|
793
|
-
TM-ARK-11: 方法行为跨平台对比
|
|
794
|
-
→ 对每个方法列出 Android/iOS/OHOS 三平台行为
|
|
795
|
-
→ 标注行为不一致
|
|
796
|
-
```
|
|
797
|
-
|
|
798
|
-
---
|
|
799
|
-
|
|
800
|
-
## 7. 报告输出格式
|
|
801
|
-
|
|
802
|
-
在一致性检视报告的"5.8 RN 架构一致性检视"中增加以下子章节:
|
|
803
|
-
|
|
804
|
-
```markdown
|
|
805
|
-
#### ArkTS TurboModule 层一致性(如适用)
|
|
806
|
-
|
|
807
|
-
**ArkTS TurboModule 模式**:{Codegen(implements TM.Xxx.Spec)/ Legacy(手写) / ⚠️ 无 ArkTS TurboModule 层}
|
|
808
|
-
|
|
809
|
-
**TurboModule 类声明一致性**:
|
|
810
|
-
|
|
811
|
-
| # | TurboModule 名 | ArkTS 类名 | NAME 常量 | JS Spec 注册名 | C++ FactoryDelegate | implements Spec? | 状态 | 扣分 |
|
|
812
|
-
|---|--------------|-----------|----------|--------------|--------------------|----------------|------|------|
|
|
813
|
-
| ... | ... | ... | ... | ... | ... | ... | ... | ... |
|
|
814
|
-
|
|
815
|
-
**TurboModule 方法级对比**:
|
|
816
|
-
|
|
817
|
-
| # | 方法名 | JS Spec 签名 | generated Spec 签名 | ArkTS TurboModule 签名 | ArkTS 文件:行号 | 实现状态 | 扣分 |
|
|
818
|
-
|---|--------|-------------|--------------------|----------------------|---------------|----------|------|
|
|
819
|
-
| ... | ... | ... | ... | ... | ... | ... | ... |
|
|
820
|
-
|
|
821
|
-
**TurboModule Stub 检测**:
|
|
822
|
-
|
|
823
|
-
| # | 方法名 | ArkTS 文件:行号 | Stub 代码 | Android 实现 | iOS 实现 | Stub 合理性 | 缺失逻辑 | 严重度 | 扣分 |
|
|
824
|
-
|---|--------|---------------|----------|-------------|---------|------------|---------|--------|------|
|
|
825
|
-
| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |
|
|
826
|
-
|
|
827
|
-
**TurboModule 常量导出对比**:
|
|
828
|
-
|
|
829
|
-
| # | 常量名 | Android getConstants() | iOS getConstants() | ArkTS TurboModule getConstants() | ArkTS 文件:行号 | 值一致性 | 状态 | 扣分 |
|
|
830
|
-
|---|--------|----------------------|--------------------|--------------------------------|---------------|---------|------|------|
|
|
831
|
-
| ... | ... | ... | ... | ... | ... | ... | ... | ... |
|
|
832
|
-
|
|
833
|
-
**TurboModule 回调/事件对比**:
|
|
834
|
-
|
|
835
|
-
| # | 回调/事件名 | JS Spec 定义 | Android 实现 | iOS 实现 | ArkTS TurboModule 实现 | ArkTS 文件:行号 | 行为一致性 | 扣分 |
|
|
836
|
-
|---|------------|-------------|-------------|---------|----------------------|---------------|-----------|------|
|
|
837
|
-
| ... | ... | ... | ... | ... | ... | ... | ... | ... |
|
|
838
|
-
|
|
839
|
-
**TurboModule 方法行为跨平台对比**:
|
|
840
|
-
|
|
841
|
-
| # | 方法名 | Android 实现摘要 | iOS 实现摘要 | ArkTS 实现摘要 | ArkTS 文件:行号 | 行为对比状态 | 扣分 |
|
|
842
|
-
|---|--------|----------------|-------------|--------------|---------------|------------|------|
|
|
843
|
-
| ... | ... | ... | ... | ... | ... | ... | ... |
|
|
844
|
-
```
|
|
845
|
-
|
|
846
|
-
---
|
|
847
|
-
|
|
848
|
-
## 8. 与 CPP_TURBOMODULE_CHECK_GUIDE 的协同
|
|
849
|
-
|
|
850
|
-
本指南与 CPP_TURBOMODULE_CHECK_GUIDE 共享"TurboModule 全链路对比表"。检视执行顺序建议:
|
|
851
|
-
|
|
852
|
-
1. **先执行 CPP_TURBOMODULE_CHECK_GUIDE** → 获得 C++ FactoryDelegate 注册名、JSIBinder 方法列表
|
|
853
|
-
2. **再执行 ARKTS_TURBOMODULE_CHECK_GUIDE** → 获得 ArkTS TurboModule 类声明、方法实现、Stub 检测、常量导出、回调/事件数据
|
|
854
|
-
3. **合并两张表** → 生成完整 TurboModule 全链路一致性分析
|
|
855
|
-
|
|
856
|
-
若两个指南独立执行,各自的全链路表可能存在重叠列。合并时以 TurboModule 名为主键,将两表的列拼接为完整链路。
|
|
1
|
+
# ArkTS TurboModule 层一致性检视指南
|
|
2
|
+
|
|
3
|
+
本指南定义 RN 鸿蒙化一致性检视中 **ArkTS TurboModule 层**(TurboModule ArkTS 实现类、generated Spec 类型、方法实现、常量导出、回调机制)的检视规范,确保 AI Agent 能系统性地读取和分析 ArkTS TurboModule 代码,检测方法 Stub、方法缺失、常量导出缺失、回调逻辑不一致等问题。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. 适用条件与前置依赖
|
|
8
|
+
|
|
9
|
+
### 1.1 适用条件
|
|
10
|
+
|
|
11
|
+
当 `harmony/<module>/src/main/ets/` 目录存在 TurboModule 实现文件(`*TurboModule.ets`)时,必须执行本指南的检视流程。若不存在,标注"⚠️ 无 ArkTS TurboModule 实现"并跳过。
|
|
12
|
+
|
|
13
|
+
判定条件:
|
|
14
|
+
|
|
15
|
+
| 条件 | 判定 |
|
|
16
|
+
|------|------|
|
|
17
|
+
| `harmony/<module>/src/main/ets/*TurboModule.ets` 存在 | ✅ ArkTS TurboModule 实现(必须检视) |
|
|
18
|
+
| `generated/turboModules/TurboModuleName.ts` 存在 | ✅ Codegen Spec 类型定义(必须检视) |
|
|
19
|
+
| 以上均不存在 | ⚠️ 无 ArkTS TurboModule 层,跳过本指南 |
|
|
20
|
+
|
|
21
|
+
### 1.2 前置依赖
|
|
22
|
+
|
|
23
|
+
- Phase 0 中已定位的 TurboModule 名(从 C++ FactoryDelegate 或 JS Spec 提取)
|
|
24
|
+
- C++ TurboModule JSIBinder 方法列表(来自 CPP_TURBOMODULE_CHECK_GUIDE)
|
|
25
|
+
- JS 层 TurboModule Spec 定义(`NativeRNCWebViewModule.ts` 等文件)
|
|
26
|
+
- C++ TurboModuleFactoryDelegate 注册名列表
|
|
27
|
+
|
|
28
|
+
### 1.3 与其他检视指南的关系
|
|
29
|
+
|
|
30
|
+
| 检视指南 | 检视层级 | 本指南关注点 |
|
|
31
|
+
|----------|----------|-------------|
|
|
32
|
+
| CPP_COMPONENT_CHECK_GUIDE | C++ 组件层 | JSIBinder Props 序列化、NapiBinder 桥接、Package 注册 |
|
|
33
|
+
| CPP_TURBOMODULE_CHECK_GUIDE | C++ TurboModule 层 | TurboModuleFactoryDelegate 注册、TurboModule JSIBinder 方法绑定 |
|
|
34
|
+
| ARKTS_COMPONENT_CHECK_GUIDE | ArkTS @Component 层 | rawProps 读取、Commands switch、事件 emit、build() 渲染 |
|
|
35
|
+
| ARKTS_TURBOMODULE_CHECK_GUIDE(本文件) | ArkTS TurboModule 层 | 方法实现完整性、Stub 检测、常量导出、回调逻辑、行为对比 |
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## 2. 文件定位与读取
|
|
40
|
+
|
|
41
|
+
### 2.1 ArkTS TurboModule 实现定位
|
|
42
|
+
|
|
43
|
+
**搜索路径**:`harmony/<module>/src/main/ets/`
|
|
44
|
+
|
|
45
|
+
| 步骤 | 搜索目标 | 搜索模式 | 目的 |
|
|
46
|
+
|------|----------|----------|------|
|
|
47
|
+
| 2.1a | TurboModule 实现文件 | `*TurboModule.ets` | 定位 ArkTS TurboModule 实际实现类 |
|
|
48
|
+
| 2.1b | TurboModule 继承方式 | `extends AnyThreadTurboModule` / `extends TurboModule` | 确定线程模型 |
|
|
49
|
+
| 2.1c | TurboModule Spec 实现 | `implements TM.Xxx.Spec` | 确认是否实现了 generated Spec 接口 |
|
|
50
|
+
|
|
51
|
+
**必须读取的文件清单**:
|
|
52
|
+
|
|
53
|
+
| # | 文件 | 说明 |
|
|
54
|
+
|---|------|------|
|
|
55
|
+
| 1 | `*TurboModule.ets`(主实现文件) | 包含 TurboModule 类声明、方法实现、常量导出 |
|
|
56
|
+
| 2 | `generated/turboModules/TurboModuleName.ts`(若存在) | Codegen Spec 类型定义(NAME 常量 + Spec 接口) |
|
|
57
|
+
| 3 | `generated/turboModules/ts.ts`(若存在) | TurboModule 命名空间导出汇总 |
|
|
58
|
+
|
|
59
|
+
### 2.2 ArkTS TurboModule 必读内容(五个维度)
|
|
60
|
+
|
|
61
|
+
#### 维度 A:类声明与 Spec 实现
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
1. 类声明
|
|
65
|
+
→ class XxxTurboModule extends AnyThreadTurboModule / TurboModule
|
|
66
|
+
→ 是否 implements TM.Xxx.Spec(Codegen 模式)
|
|
67
|
+
→ 是否手写 Spec 接口(Legacy 模式)
|
|
68
|
+
|
|
69
|
+
2. NAME 常量
|
|
70
|
+
→ TurboModule 注册名(TM.Xxx.NAME 或手写常量)
|
|
71
|
+
→ 与 JS Spec TurboModuleRegistry.getEnforcing<Spec>('XXX') 的模块名对比
|
|
72
|
+
→ 与 C++ FactoryDelegate 注册名对比
|
|
73
|
+
|
|
74
|
+
3. 构造方法
|
|
75
|
+
→ constructor(ctx: TurboModuleContext, name: string)
|
|
76
|
+
→ 是否在构造中初始化了必要的状态变量
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
**类声明提取模板**:
|
|
80
|
+
|
|
81
|
+
```markdown
|
|
82
|
+
| # | TurboModule 名 | ArkTS 类名 | ArkTS 父类 | implements Spec? | NAME 常量值 | JS Spec 注册名 | C++ FactoryDelegate 注册名 | 状态 |
|
|
83
|
+
|---|--------------|-----------|-----------|-----------------|------------|--------------|------------------------|------|
|
|
84
|
+
| 1 | `RNCWebViewModule` | `WebViewTurboModule` | `AnyThreadTurboModule` | ✅ TM.RNCWebViewModule.Spec | `RNCWebViewModule` | `RNCWebViewModule` ✅ | `RNCWebViewModule` ✅ | ✅ 全链路一致 |
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
#### 维度 B:方法实现完整性
|
|
88
|
+
|
|
89
|
+
```
|
|
90
|
+
1. 方法名列表
|
|
91
|
+
→ 提取所有 public 方法名
|
|
92
|
+
→ 与 JS Spec 方法名对比
|
|
93
|
+
→ 与 generated Spec 接口方法名对比
|
|
94
|
+
|
|
95
|
+
2. 方法签名
|
|
96
|
+
→ 提取每个方法的参数类型和返回值类型
|
|
97
|
+
→ 与 JS Spec 签名对比
|
|
98
|
+
|
|
99
|
+
3. 方法实现状态
|
|
100
|
+
→ 是否为正常实现(调用了 @ohos API 或业务逻辑)
|
|
101
|
+
→ 是否为 Stub(返回固定值、空方法体、仅日志)
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
**方法级对比模板**:
|
|
105
|
+
|
|
106
|
+
```markdown
|
|
107
|
+
| # | 方法名 | JS Spec 签名 | generated Spec 签名 | ArkTS TurboModule 签名 | ArkTS 文件:行号 | 实现状态 | 扣分 |
|
|
108
|
+
|---|--------|-------------|--------------------|----------------------|---------------|----------|------|
|
|
109
|
+
| 1 | `isFileUploadSupported` | `(): Promise<boolean>` | `(): Promise<boolean>` | `(): Promise<boolean>` | `WebViewTurboModule.ets:14` | ⚠️ Stub(固定返回 true) | -8 |
|
|
110
|
+
| 2 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | `(shouldStart: boolean, lockIdentifier: number): void` | `(shouldStart: boolean, lockIdentifier: number): void` | `WebViewTurboModule.ets:18` | ✅ 正常实现 | 0 |
|
|
111
|
+
| 3 | `injectJavaScript` | `(script: string): void` | `(script: string): void` | ⛔ 不存在 | — | ❌ 方法缺失 | -15 |
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
#### 维度 C:Stub 检测
|
|
115
|
+
|
|
116
|
+
```
|
|
117
|
+
1. Stub 识别特征
|
|
118
|
+
→ 方法体仅有 return 语句,返回固定值
|
|
119
|
+
→ 未调用任何 @ohos 模块 API
|
|
120
|
+
→ 未执行实际业务操作
|
|
121
|
+
→ 仅日志输出(console.log)
|
|
122
|
+
|
|
123
|
+
2. Stub 合理性判定
|
|
124
|
+
→ 与 Android/iOS 同名方法对比行为
|
|
125
|
+
→ iOS 也返回固定值 → 合理 Stub(不扣分)
|
|
126
|
+
→ Android 有实际业务逻辑 → 致命 Stub(扣分)
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
**Stub 检测模板**:
|
|
130
|
+
|
|
131
|
+
```markdown
|
|
132
|
+
| # | 方法名 | ArkTS 文件:行号 | Stub 代码片段 | Android 实现 | iOS 实现 | Stub 合理性 | 缺失逻辑 | 严重度 | 扣分 |
|
|
133
|
+
|---|--------|---------------|--------------|-------------|---------|------------|---------|--------|------|
|
|
134
|
+
| 1 | `isFileUploadSupported` | `WebViewTurboModule.ets:14` | `return Promise.resolve(true)` | ✅ Android 5+ 返回 true | ✅ 始终返回 YES | ✅ 三平台一致 | 无 | ⚠️ 合理 | 0 |
|
|
135
|
+
| 2 | `removeBond` | `BleTurboModule.ets:278` | `return true;` | ✅ 调用 BluetoothDevice.removeBond() | ✅ 调用 CBCentralManager.remove() | ❌ 缺失实际解绑 | 实际解绑操作 | ❌ 致命 | -8 |
|
|
136
|
+
| 3 | `requestPriority` | `BleTurboModule.ets:455` | `// todo: implement` | ✅ 调用 gatt.requestConnectionPriority() | ⛔ 不支持 | ❌ 空方法体 | 优先级请求 | ❌ 致命 | -8 |
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
#### 维度 D:常量导出
|
|
140
|
+
|
|
141
|
+
```
|
|
142
|
+
1. getConstants() 方法(若有)
|
|
143
|
+
→ 提取所有导出的常量名和值
|
|
144
|
+
→ 与 Android/iOS getConstants() 对比
|
|
145
|
+
|
|
146
|
+
2. 常量值一致性
|
|
147
|
+
→ 各平台导出的常量值是否一致
|
|
148
|
+
→ 常量名拼写是否一致
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
**常量导出对比模板**:
|
|
152
|
+
|
|
153
|
+
```markdown
|
|
154
|
+
| # | 常量名 | Android getConstants() | iOS getConstants() | ArkTS TurboModule getConstants() | ArkTS 文件:行号 | 值一致性 | 状态 | 扣分 |
|
|
155
|
+
|---|--------|----------------------|--------------------|--------------------------------|---------------|---------|------|------|
|
|
156
|
+
| 1 | `Scale` | `{Scale: 0.0001}` | `{Scale: 0.0001}` | `{Scale: 0.0001}` | `MapsTurboModule.ets:25` | ✅ | ✅ 一致 | 0 |
|
|
157
|
+
| 2 | `ConnectionPriority` | `{HIGH: 1, BALANCED: 0, LOW_POWER: -1}` | ⛔ 无 | ⛔ 无 | — | — | ⚠️ 仅 Android 有 | -3 |
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
#### 维度 E:回调/事件机制
|
|
161
|
+
|
|
162
|
+
```
|
|
163
|
+
1. 回调方法
|
|
164
|
+
→ TurboModule 中定义的回调方法(如 shouldStartLoadWithLockIdentifier)
|
|
165
|
+
→ 回调触发时机和方式
|
|
166
|
+
|
|
167
|
+
2. 事件发送
|
|
168
|
+
→ TurboModule 是否通过 emitDeviceEvent / sendEvent 发送事件
|
|
169
|
+
→ 事件名与 payload 是否与 Android/iOS 一致
|
|
170
|
+
|
|
171
|
+
3. 回调参数类型
|
|
172
|
+
→ 回调方法的参数类型映射是否正确
|
|
173
|
+
→ 与 JS Spec 回调参数类型对比
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
**回调/事件对比模板**:
|
|
177
|
+
|
|
178
|
+
```markdown
|
|
179
|
+
| # | 回调/事件名 | JS Spec 定义 | Android 实现 | iOS 实现 | ArkTS TurboModule 实现 | ArkTS 文件:行号 | 行为一致性 | 扣分 |
|
|
180
|
+
|---|------------|-------------|-------------|---------|----------------------|---------------|-----------|------|
|
|
181
|
+
| 1 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | ✅ AtomicReference + notify | ✅ DecisionManager setResult | ✅ ShouldStartParams + lockState | `WebViewTurboModule.ets:18` | ✅ 功能一致 | 0 |
|
|
182
|
+
| 2 | `onBluetoothStateChange` | `event: {state: string}` | ✅ sendEvent("onBluetoothStateChange", {state}) | ✅ RCTEventEmitter | ⛔ 未发送事件 | — | ❌ 事件缺失 | -8 |
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
---
|
|
186
|
+
|
|
187
|
+
## 3. 检视项与扣分规则
|
|
188
|
+
|
|
189
|
+
> 本指南覆盖 `arktsTM` 类型实体,检视项按三个关键检查点组织:**函数签名、返回值、实现逻辑**。**最关键检查项为实现逻辑一致性**。
|
|
190
|
+
|
|
191
|
+
### 3.0 前置过滤:原生注册缺失检测(优先级最高)
|
|
192
|
+
|
|
193
|
+
> ⚠️ **此步骤必须在所有方法级检视(3.1-3.3)之前执行**。未注册的 TM 整体不可达,其内部方法逐项检视会导致重复扣分且无实际意义。
|
|
194
|
+
|
|
195
|
+
- **检查项**: 原生注册缺失检测
|
|
196
|
+
- **适用场景**: 当 JS/TS Spec 注册的 TurboModule 名在 ArkTS Factory 中未注册时,该 TM 整体不可达(JS 调用 `TurboModuleRegistry.getEnforcing` 将失败),此时应跳过该 TM 内部所有方法的逐项检视。
|
|
197
|
+
- **特征检索方式**:
|
|
198
|
+
1. 在 `generated/turboModules/*.ts` 中提取所有 TurboModule `NAME` 常量
|
|
199
|
+
2. 在 `*Package.ets` 中提取 `createTurboModule()` 方法的 `if(name===)` 条件
|
|
200
|
+
- **检视步骤**:
|
|
201
|
+
1. 读取 `generated/turboModules/*.ts`,提取所有 TurboModule NAME 常量 → 列表TM_js
|
|
202
|
+
2. 读取 `*Package.ets` 的 `createTurboModule` 方法,提取所有 `if(name===)` 条件中的 TM 名 → 列表TM_registered
|
|
203
|
+
3. 对每个 TM_js 中的名称,检查是否存在于 TM_registered 中
|
|
204
|
+
4. 判定规则:
|
|
205
|
+
- **TM 已注册** → ✅ 通过,继续 3.1-3.3 的正常方法级检视
|
|
206
|
+
- **TM 未注册** → ❌ 致命,扣 -15/实体名,**跳过该 TM 内部所有方法的逐项检视**(方法存在性、签名一致性、参数类型、返回值、实现逻辑等均不再检查)
|
|
207
|
+
5. 将跳过的 TM 记入输出表,明确标注"⛔ 跳过逐项检查"
|
|
208
|
+
- **扣分规则**: 未注册→致命-15/实体名;跳过的方法不计入致命问题计数
|
|
209
|
+
- **输出格式**:
|
|
210
|
+
|
|
211
|
+
```markdown
|
|
212
|
+
| # | 实体类型 | JS/TS Spec 注册名 | ArkTS Factory 注册 | 状态 | 致命度 | 扣分 | 内部方法检查 |
|
|
213
|
+
|---|---------|-----------------|-------------------|------|--------|------|------------|
|
|
214
|
+
| 1 | TurboModule | `RNCWebViewModule` | ✅ 已注册 | ✅ 通过 | — | 0 | 继续逐项检视 |
|
|
215
|
+
| 2 | TurboModule | `RNCWebView` | ❌ 未注册 | ❌ 致命 | -15 | ⛔ 跳过 |
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
**⚠️ 关键说明**:
|
|
219
|
+
- 跳过的 TM 内部方法**不计入致命问题计数**,避免因方法级重复扣分触发归零规则
|
|
220
|
+
- 此规则仅适用于 TM 整体未注册(无 ArkTS Factory 条件)的场景。若 TM 已注册但部分方法缺失,仍按检查项 3(方法存在性)的正常规则扣分
|
|
221
|
+
|
|
222
|
+
### 3.1 检查点:函数签名(仅对已注册的 TM 执行)
|
|
223
|
+
|
|
224
|
+
#### 检查项概要
|
|
225
|
+
|
|
226
|
+
| # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
|
|
227
|
+
|---|--------|------|----------|----------|--------|
|
|
228
|
+
| 1 | NAME常量一致性 | ①契约一致性 | ArkTS NAME vs JS Spec注册名 vs C++ FactoryDelegate注册名 | 不一致→-5分/个 | 中等 |
|
|
229
|
+
| 2 | 方法签名一致性 | ①契约一致性 | ArkTS方法签名 vs generated Spec签名 vs JS Spec签名 | 签名不匹配→-8分/个 | 严重 |
|
|
230
|
+
| 3 | 方法存在性 | ①契约一致性 | JS Spec方法名 vs ArkTS TurboModule方法名 | 方法缺失→-15分/个 | 致命 |
|
|
231
|
+
| 4 | 参数数量 | ①契约一致性 | JS Spec参数数量 vs ArkTS TurboModule参数数量 | 不匹配→-8分 | 致命 |
|
|
232
|
+
| 5 | 参数类型 | ①契约一致性 | ArkTS TurboModule参数类型 vs JS Spec参数类型 | 类型致命错误→-10分/个 | 致命 |
|
|
233
|
+
| 6 | 参数顺序 | ①契约一致性 | JS Spec参数位置 vs ArkTS TurboModule参数位置 | 顺序错误→-6分 | 中等 |
|
|
234
|
+
| 7 | 方法签名vs Android | ②平台实现差异 | ArkTS TurboModule方法签名 vs Android @ReactMethod签名 | 合并至①检查 | — |
|
|
235
|
+
| 8 | 方法签名vs iOS | ②平台实现差异 | ArkTS TurboModule方法签名 vs iOS RCT_EXPORT_METHOD签名 | 合并至①检查 | — |
|
|
236
|
+
| 9 | Spec接口实现 | ③架构桥接一致性 | ArkTS TurboModule是否implements generated Spec接口 | 未实现→-8分/个 | 严重 |
|
|
237
|
+
|
|
238
|
+
> ⚠️ **前置过滤规则(3.0节)优先级最高**:检查项 1-9 仅对**已注册的 TM** 执行。未注册的 TM 整体在 3.0 中已扣致命-15,其内部方法不再逐项检视。
|
|
239
|
+
|
|
240
|
+
#### ①契约一致性
|
|
241
|
+
|
|
242
|
+
##### 检查项1:NAME常量一致性
|
|
243
|
+
|
|
244
|
+
- **检查项**: NAME常量一致性
|
|
245
|
+
- **特征检索方式**: 在 `*TurboModule.ets` 中 grep `NAME = ` 或 `static NAME`;在 JS Spec 中 grep `TurboModuleRegistry.getEnforcing`;在 C++ FactoryDelegate 中 grep `if(name=="`
|
|
246
|
+
- **检视步骤**:
|
|
247
|
+
1. 读取 `*TurboModule.ets`,提取 NAME 常量值(格式为 `TM.Xxx.NAME` 或 `static NAME = "xxx"`)
|
|
248
|
+
2. 读取 JS Spec 文件,提取 `TurboModuleRegistry.getEnforcing<Spec>('XXX')` 中的模块注册名
|
|
249
|
+
3. 读取 C++ FactoryDelegate 文件,提取 `if(name=="XXX")` 条件中的注册名
|
|
250
|
+
4. 比较三者:ArkTS NAME值、JS Spec注册名、C++ FactoryDelegate注册名
|
|
251
|
+
5. 判定规则:三者完全一致→通过;任一不一致→标注不一致并扣分
|
|
252
|
+
- **扣分规则**: 不一致→中等-5分/个
|
|
253
|
+
- **输出格式**:
|
|
254
|
+
|
|
255
|
+
```markdown
|
|
256
|
+
| # | NAME来源 | NAME值 | 是否一致 | 扣分 |
|
|
257
|
+
|---|---------|--------|---------|------|
|
|
258
|
+
| 1 | ArkTS TurboModule NAME常量 | `"RNCWebViewModule"` | — | — |
|
|
259
|
+
| 2 | JS Spec TurboModuleRegistry注册名 | `'RNCWebViewModule'` | ✅/❌ | 0/-5 |
|
|
260
|
+
| 3 | C++ FactoryDelegate注册名 | `"RNCWebViewModule"` | ✅/❌ | 0/-5 |
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
##### 检查项2:方法签名一致性
|
|
264
|
+
|
|
265
|
+
- **检查项**: 方法签名一致性
|
|
266
|
+
- **特征检索方式**: 在 `*TurboModule.ets` 中 grep 所有 public 方法声明;在 generated Spec ts 文件中 grep interface 方法签名;在 JS Spec 中 grep 方法签名
|
|
267
|
+
- **检视步骤**:
|
|
268
|
+
1. 从 `*TurboModule.ets` 提取所有 public 方法名及完整签名(参数类型+返回值类型)→列表M
|
|
269
|
+
2. 从 generated Spec ts 文件提取所有 interface 方法签名→列表S
|
|
270
|
+
3. 从 JS Spec 提取所有方法签名→列表J
|
|
271
|
+
4. 逐方法对比 M vs S vs J:方法名相同则对比参数类型、参数顺序、返回值类型是否完全匹配
|
|
272
|
+
5. 判定规则:签名完全一致→通过;任一不匹配→标注不匹配项并扣分
|
|
273
|
+
- **扣分规则**: 签名不匹配→严重-8分/个
|
|
274
|
+
- **输出格式**:
|
|
275
|
+
|
|
276
|
+
```markdown
|
|
277
|
+
| # | 方法名 | ArkTS TurboModule签名 | generated Spec签名 | JS Spec签名 | 签名一致性 | 不匹配详情 | 扣分 |
|
|
278
|
+
|---|--------|----------------------|--------------------|------------|-----------|-----------|------|
|
|
279
|
+
| 1 | `connect` | `(id: string): void` | `(id: string): void` | `(id: string): void` | ✅ | — | 0 |
|
|
280
|
+
| 2 | `readRSSI` | `(id: number): Promise<number>` | `(id: string): Promise<number>` | `(id: string): Promise<number>` | ❌ | ArkTS参数类型number vs string | -8 |
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
##### 检查项3:方法存在性
|
|
284
|
+
|
|
285
|
+
- **检查项**: 方法存在性
|
|
286
|
+
- **特征检索方式**: 在 JS Spec 中提取所有方法名列表;在 `*TurboModule.ets` 中 grep 所有 public 方法名;在文档中搜索不支持标注
|
|
287
|
+
- **检视步骤**:
|
|
288
|
+
1. 从 JS Spec 提取所有方法名→列表J
|
|
289
|
+
2. 从 `*TurboModule.ets` 提取所有 public 方法名→列表A
|
|
290
|
+
3. 对每个 JS Spec 方法名,检查是否存在于列表A中
|
|
291
|
+
4. **🟢 豁免检查(优先级高于扣分)**:对每个 ArkTS 缺失的方法,检查文档是否标注不支持:
|
|
292
|
+
- 查找 **接口规格说明**(如 `接口规格说明.md`),该方法行是否有 `(Android only)`、`(iOS only)`、`(不支持)` 等标注
|
|
293
|
+
- 查找 **OHOS README**(如 `harmony/README.md`),"HarmonyOS Support" 列是否为 "No","Platform" 列是否非 "All" 且非 "HarmonyOS"
|
|
294
|
+
- 查找 **源码注释**,是否有 `// not supported`、`// Android only` 等标注
|
|
295
|
+
5. 判定规则:
|
|
296
|
+
- 🟢 **文档已标注不支持** → 豁免,0分,标注"🟢 文档标注不支持(来源:文件:行号)"
|
|
297
|
+
- ❌ **文档未标注不支持** → 方法缺失→致命-15分/个
|
|
298
|
+
- **扣分规则**: 方法缺失→致命-15分/个;文档标注不支持→豁免0分(不计入致命问题计数)
|
|
299
|
+
- **输出格式**:
|
|
300
|
+
|
|
301
|
+
```markdown
|
|
302
|
+
| # | 方法名 | JS Spec存在 | ArkTS TurboModule存在 | 文档标注不支持 | 文档来源 | 状态 | 扣分 |
|
|
303
|
+
|---|--------|------------|----------------------|--------------|---------|------|------|
|
|
304
|
+
| 1 | `connect` | ✅ | ✅ | — | — | ✅ 方法存在 | 0 |
|
|
305
|
+
| 2 | `clearFormData` | ✅ | ❌ | ✅ Android only, HarmonyOS Support: No | README.md:380 | 🟢 豁免不扣分 | 0 |
|
|
306
|
+
| 3 | `injectJavaScript` | ✅ | ❌ | ❌ 无标注 | — | ❌ 方法缺失 | -15 |
|
|
307
|
+
```
|
|
308
|
+
|
|
309
|
+
##### 检查项4:参数数量
|
|
310
|
+
|
|
311
|
+
- **检查项**: 参数数量
|
|
312
|
+
- **特征检索方式**: 在 JS Spec 中统计每个方法参数数量;在 `*TurboModule.ets` 中统计每个方法参数数量
|
|
313
|
+
- **检视步骤**:
|
|
314
|
+
1. 从 JS Spec 逐方法统计参数数量→映射Q_js
|
|
315
|
+
2. 从 `*TurboModule.ets` 逐方法统计参数数量→映射Q_arkts
|
|
316
|
+
3. 对每个共有方法,对比 Q_js[method] vs Q_arkts[method]
|
|
317
|
+
4. 判定规则:数量一致→通过;不匹配→标注差异并扣分
|
|
318
|
+
- **扣分规则**: 不匹配→致命-8分
|
|
319
|
+
- **输出格式**:
|
|
320
|
+
|
|
321
|
+
```markdown
|
|
322
|
+
| # | 方法名 | JS Spec参数数量 | ArkTS TurboModule参数数量 | 是否一致 | 扣分 |
|
|
323
|
+
|---|--------|---------------|-------------------------|---------|------|
|
|
324
|
+
| 1 | `connect` | 1 | 1 | ✅ | 0 |
|
|
325
|
+
| 2 | `startScan` | 3 | 2 | ❌ | -8 |
|
|
326
|
+
```
|
|
327
|
+
|
|
328
|
+
##### 检查项5:参数类型
|
|
329
|
+
|
|
330
|
+
- **检查项**: 参数类型
|
|
331
|
+
- **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法参数的类型标注;在 JS Spec 中读取对应方法参数类型定义
|
|
332
|
+
- **检视步骤**:
|
|
333
|
+
1. 从 `*TurboModule.ets` 逐方法读取每个参数的类型标注→映射T_arkts
|
|
334
|
+
2. 从 JS Spec 逐方法读取每个参数的类型定义→映射T_js
|
|
335
|
+
3. 对每个共有方法的每个参数,对比 T_arkts[method][param] vs T_js[method][param]
|
|
336
|
+
4. 判定规则:类型完全匹配或为合理的跨平台类型映射(如Double→number)→通过;类型致命错误→标注并扣分
|
|
337
|
+
- **扣分规则**: 类型致命错误→致命-10分/个
|
|
338
|
+
- **输出格式**:
|
|
339
|
+
|
|
340
|
+
```markdown
|
|
341
|
+
| # | 方法名 | 参数位置 | JS Spec类型 | ArkTS TurboModule类型 | 类型一致性 | 扣分 |
|
|
342
|
+
|---|--------|---------|------------|----------------------|-----------|------|
|
|
343
|
+
| 1 | `shouldStartLoadWithLockIdentifier` | 参数1 | `boolean` | `boolean` | ✅ | 0 |
|
|
344
|
+
| 2 | `shouldStartLoadWithLockIdentifier` | 参数2 | `Double` | `number` | ✅(合理映射) | 0 |
|
|
345
|
+
| 3 | `readRSSI` | 参数1 | `string` | `number` | ❌ | -10 |
|
|
346
|
+
```
|
|
347
|
+
|
|
348
|
+
##### 检查项6:参数顺序
|
|
349
|
+
|
|
350
|
+
- **检查项**: 参数顺序
|
|
351
|
+
- **特征检索方式**: 在 JS Spec 中提取每个方法参数定义顺序;在 `*TurboModule.ets` 中提取每个方法参数声明顺序
|
|
352
|
+
- **检视步骤**:
|
|
353
|
+
1. 从 JS Spec 逐方法提取参数定义顺序→映射O_js
|
|
354
|
+
2. 从 `*TurboModule.ets` 逐方法提取参数声明顺序→映射O_arkts
|
|
355
|
+
3. 对每个共有方法,逐参数位置对比 O_js[method][i] vs O_arkts[method][i] 的参数名
|
|
356
|
+
4. 判定规则:同名参数位置完全一致→通过;顺序错误→标注并扣分
|
|
357
|
+
- **扣分规则**: 顺序错误→中等-6分
|
|
358
|
+
- **输出格式**:
|
|
359
|
+
|
|
360
|
+
```markdown
|
|
361
|
+
| # | 方法名 | JS Spec参数顺序 | ArkTS TurboModule参数顺序 | 顺序一致性 | 扣分 |
|
|
362
|
+
|---|--------|----------------|-------------------------|-----------|------|
|
|
363
|
+
| 1 | `connect` | `(id, options)` | `(id, options)` | ✅ | 0 |
|
|
364
|
+
| 2 | `startScan` | `(filter, options, callback)` | `(options, filter, callback)` | ❌ | -6 |
|
|
365
|
+
```
|
|
366
|
+
|
|
367
|
+
#### ②平台实现差异
|
|
368
|
+
|
|
369
|
+
##### 检查项7:方法签名vs Android
|
|
370
|
+
|
|
371
|
+
- **检查项**: 方法签名vs Android
|
|
372
|
+
- **特征检索方式**: 在 Android Java/Kotlin 文件中 grep `@ReactMethod` 注解的方法签名;在 `*TurboModule.ets` 中 grep public 方法签名
|
|
373
|
+
- **检视步骤**:
|
|
374
|
+
1. 从 `*TurboModule.ets` 提取所有方法签名→列表M
|
|
375
|
+
2. 从 Android Java/Kotlin TurboModule 文件中读取所有 `@ReactMethod` 标注的方法签名→列表A_android
|
|
376
|
+
3. 对每个共有方法,对比 M[method] vs A_android[method] 的参数数量、参数类型、返回值类型
|
|
377
|
+
4. 判定规则:差异项合并至①契约一致性检查,不独立扣分;Android签名差异视为JS Spec签名差异的补充参考
|
|
378
|
+
- **扣分规则**: 差异合并至①检查,不独立扣分
|
|
379
|
+
- **输出格式**:
|
|
380
|
+
|
|
381
|
+
```markdown
|
|
382
|
+
| # | 方法名 | ArkTS TurboModule签名 | Android @ReactMethod签名 | 差异 | 合并至①检查项 |
|
|
383
|
+
|---|--------|----------------------|------------------------|------|-------------|
|
|
384
|
+
| 1 | `connect` | `(id: string): void` | `(String id): void` | ✅ 功能一致 | — |
|
|
385
|
+
| 2 | `requestPriority` | `(priority: number): void` | `(int priority): void` | ✅ 合理映射 | — |
|
|
386
|
+
```
|
|
387
|
+
|
|
388
|
+
##### 检查项8:方法签名vs iOS
|
|
389
|
+
|
|
390
|
+
- **检查项**: 方法签名vs iOS
|
|
391
|
+
- **特征检索方式**: 在 iOS 文件中 grep `RCT_EXPORT_METHOD` 宏定义的方法签名;在 `*TurboModule.ets` 中 grep public 方法签名
|
|
392
|
+
- **检视步骤**:
|
|
393
|
+
1. 从 `*TurboModule.ets` 提取所有方法签名→列表M
|
|
394
|
+
2. 从 iOS TurboModule 文件中读取所有 `RCT_EXPORT_METHOD` 定义的签名→列表A_ios
|
|
395
|
+
3. 对每个共有方法,对比 M[method] vs A_ios[method] 的参数数量、参数类型、返回值类型
|
|
396
|
+
4. 判定规则:差异项合并至①契约一致性检查,不独立扣分;iOS签名差异视为JS Spec签名差异的补充参考
|
|
397
|
+
- **扣分规则**: 差异合并至①检查,不独立扣分
|
|
398
|
+
- **输出格式**:
|
|
399
|
+
|
|
400
|
+
```markdown
|
|
401
|
+
| # | 方法名 | ArkTS TurboModule签名 | iOS RCT_EXPORT_METHOD签名 | 差异 | 合并至①检查项 |
|
|
402
|
+
|---|--------|----------------------|--------------------------|------|-------------|
|
|
403
|
+
| 1 | `connect` | `(id: string): void` | `(NSString *id)` | ✅ 功能一致 | — |
|
|
404
|
+
| 2 | `readRSSI` | `(id: number): Promise<number>` | `(NSString *deviceID)` | 参数名差异 | 参考① |
|
|
405
|
+
```
|
|
406
|
+
|
|
407
|
+
#### ③架构桥接一致性
|
|
408
|
+
|
|
409
|
+
##### 检查项9:Spec接口实现
|
|
410
|
+
|
|
411
|
+
- **检查项**: Spec接口实现
|
|
412
|
+
- **特征检索方式**: 在 `*TurboModule.ets` 中 grep `implements TM.Xxx.Spec` 或类声明中的 implements 关系
|
|
413
|
+
- **检视步骤**:
|
|
414
|
+
1. 读取 `*TurboModule.ets` 中 TurboModule 类声明行
|
|
415
|
+
2. 检查类声明是否包含 `implements TM.Xxx.Spec`(Codegen模式)或手写 Spec 接口(Legacy模式)
|
|
416
|
+
3. 判定规则:实现了 generated Spec 接口→通过;未实现→标注并扣分
|
|
417
|
+
- **扣分规则**: 未实现→严重-8分/个
|
|
418
|
+
- **输出格式**:
|
|
419
|
+
|
|
420
|
+
```markdown
|
|
421
|
+
| # | TurboModule名 | ArkTS类声明 | implements Spec? | Spec接口来源 | 状态 | 扣分 |
|
|
422
|
+
|---|--------------|------------|-----------------|------------|------|------|
|
|
423
|
+
| 1 | `RNCWebViewModule` | `class WebViewTurboModule extends AnyThreadTurboModule implements TM.RNCWebViewModule.Spec` | ✅ | generated Codegen | ✅ 已实现 | 0 |
|
|
424
|
+
| 2 | `BleManagerModule` | `class BleTurboModule extends TurboModule` | ❌ | — | ❌ 未实现 | -8 |
|
|
425
|
+
```
|
|
426
|
+
|
|
427
|
+
---
|
|
428
|
+
|
|
429
|
+
### 3.2 检查点:返回值
|
|
430
|
+
|
|
431
|
+
#### 检查项概要
|
|
432
|
+
|
|
433
|
+
| # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
|
|
434
|
+
|---|--------|------|----------|----------|--------|
|
|
435
|
+
| 1 | 返回值类型 | ①契约一致性 | ArkTS TurboModule返回值 vs JS Spec期望返回值 | 返回值类型错误→-10分/个 | 致命 |
|
|
436
|
+
| 2 | 返回值语义 | ①契约一致性 | ArkTS TurboModule返回内容 vs JS Spec接口语义 | 语义不匹配→视严重度扣分 | 严重/中等 |
|
|
437
|
+
| 3 | Promise处理 | ①契约一致性 | ArkTS TurboModule异步方法返回值 vs JS Spec异步声明 | Promise未正确包裹→-8分/个 | 严重 |
|
|
438
|
+
| 4 | 常量导出完整性 | ①契约一致性 | ArkTS TurboModule getConstants() vs Android/iOS getConstants() | 失常量→-5分/个 | 中等 |
|
|
439
|
+
| 5 | 常量值一致性 | ①契约一致性 | 各平台导出的常量值 | 值不一致→-3分/个 | 轻微 |
|
|
440
|
+
| 6 | 返回值vs Android/iOS | ②平台实现差异 | ArkTS TurboModule方法返回值 vs Android/iOS方法返回值 | 合并至①检查 | — |
|
|
441
|
+
| — | ③架构桥接一致性 | — | 已由①覆盖 | — | — |
|
|
442
|
+
|
|
443
|
+
#### ①契约一致性
|
|
444
|
+
|
|
445
|
+
##### 检查项1:返回值类型
|
|
446
|
+
|
|
447
|
+
- **检查项**: 返回值类型
|
|
448
|
+
- **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法的返回值类型标注;在 JS Spec 中读取对应方法的期望返回值类型
|
|
449
|
+
- **检视步骤**:
|
|
450
|
+
1. 从 `*TurboModule.ets` 逐方法读取返回值类型标注→映射R_arkts
|
|
451
|
+
2. 从 JS Spec 逐方法读取期望返回值类型→映射R_js
|
|
452
|
+
3. 对每个共有方法,对比 R_arkts[method] vs R_js[method]
|
|
453
|
+
4. 判定规则:类型完全匹配或为合理跨平台映射→通过;返回值类型错误→标注并扣分
|
|
454
|
+
- **扣分规则**: 返回值类型错误→致命-10分/个
|
|
455
|
+
- **输出格式**:
|
|
456
|
+
|
|
457
|
+
```markdown
|
|
458
|
+
| # | 方法名 | JS Spec期望返回值类型 | ArkTS TurboModule返回值类型 | 类型一致性 | 扣分 |
|
|
459
|
+
|---|--------|--------------------|--------------------------|-----------|------|
|
|
460
|
+
| 1 | `isFileUploadSupported` | `Promise<boolean>` | `Promise<boolean>` | ✅ | 0 |
|
|
461
|
+
| 2 | `connect` | `void` | `Promise<void>` | ❌(多包裹Promise) | -10 |
|
|
462
|
+
```
|
|
463
|
+
|
|
464
|
+
##### 检查项2:返回值语义
|
|
465
|
+
|
|
466
|
+
- **检查项**: 返回值语义
|
|
467
|
+
- **特征检索方式**: 在 `*TurboModule.ets` 中读取每个方法的方法体,验证返回值的语义正确性;在 JS Spec 中读取接口语义描述
|
|
468
|
+
- **检视步骤**:
|
|
469
|
+
1. 读取 `*TurboModule.ets` 中每个方法的方法体,分析返回内容是否符合接口语义
|
|
470
|
+
2. 读取 JS Spec 中对应方法的语义描述(方法名、注释、类型语义)
|
|
471
|
+
3. 对比 ArkTS 实际返回值语义是否与 JS Spec 接口语义一致
|
|
472
|
+
4. 判定规则:语义一致→通过;语义不匹配→视严重度扣分
|
|
473
|
+
- **扣分规则**: 语义严重不匹配→严重扣分;轻微语义偏差→中等扣分
|
|
474
|
+
- **输出格式**:
|
|
475
|
+
|
|
476
|
+
```markdown
|
|
477
|
+
| # | 方法名 | JS Spec接口语义 | ArkTS TurboModule返回语义 | 语义一致性 | 扣分 |
|
|
478
|
+
|---|--------|---------------|--------------------------|-----------|------|
|
|
479
|
+
| 1 | `isFileUploadSupported` | 返回当前设备是否支持文件上传 | 固定返回true(语义:始终支持) | ✅ | 0 |
|
|
480
|
+
| 2 | `getOpenPeripherals` | 返回已连接的外围设备列表 | 返回空数组[](语义:无设备) | ❌ | -5 |
|
|
481
|
+
```
|
|
482
|
+
|
|
483
|
+
##### 检查项3:Promise处理
|
|
484
|
+
|
|
485
|
+
- **检查项**: Promise处理
|
|
486
|
+
- **特征检索方式**: 在 JS Spec 中 grep `Promise<` 或标注为异步的方法;在 `*TurboModule.ets` 中 grep `Promise<` 或 `async` 关键字
|
|
487
|
+
- **检视步骤**:
|
|
488
|
+
1. 从 `*TurboModule.ets` 检查每个方法是否返回 Promise→映射P_arkts
|
|
489
|
+
2. 从 JS Spec 检查哪些方法声明为异步(返回值类型含 Promise)→映射P_js
|
|
490
|
+
3. 对每个共有方法,对比 P_arkts[method] vs P_js[method]
|
|
491
|
+
4. 验证 ArkTS 异步方法是否正确使用 `Promise.resolve()`/`Promise.reject()` 包裹返回值
|
|
492
|
+
5. 判定规则:JS Spec异步方法在ArkTS也返回Promise且包裹正确→通过;异步未包裹Promise→标注并扣分
|
|
493
|
+
- **扣分规则**: Promise未正确包裹→严重-8分/个
|
|
494
|
+
- **输出格式**:
|
|
495
|
+
|
|
496
|
+
```markdown
|
|
497
|
+
| # | 方法名 | JS Spec是否异步 | ArkTS TurboModule是否返回Promise | Promise包裹正确性 | 扣分 |
|
|
498
|
+
|---|--------|---------------|-------------------------------|-----------------|------|
|
|
499
|
+
| 1 | `isFileUploadSupported` | ✅ Promise<boolean> | ✅ Promise.resolve(true) | ✅ | 0 |
|
|
500
|
+
| 2 | `readRSSI` | ✅ Promise<number> | ❌ 直接返回number | ❌ | -8 |
|
|
501
|
+
```
|
|
502
|
+
|
|
503
|
+
##### 检查项4:常量导出完整性
|
|
504
|
+
|
|
505
|
+
- **检查项**: 常量导出完整性
|
|
506
|
+
- **特征检索方式**: 在 `*TurboModule.ets` 中 grep `getConstants()` 方法;在 Android Java 中 grep `getConstants()` 方法;在 iOS 中 grep `getConstants()` 或常量导出相关代码
|
|
507
|
+
- **检视步骤**:
|
|
508
|
+
1. 从 `*TurboModule.ets` 读取 `getConstants()` 方法,提取所有常量名→列表O
|
|
509
|
+
2. 从 Android Java TurboModule 文件读取 `getConstants()` 方法,提取所有常量名→列表A
|
|
510
|
+
3. 从 iOS TurboModule 文件读取常量导出代码,提取所有常量名→列表I
|
|
511
|
+
4. 对比 O vs A vs I:检查每个常量是否在三平台均有导出
|
|
512
|
+
5. 判定规则:三平台均导出→通过;任一平台失常量→标注并扣分
|
|
513
|
+
- **扣分规则**: 失常量→中等-5分/个
|
|
514
|
+
- **输出格式**:
|
|
515
|
+
|
|
516
|
+
```markdown
|
|
517
|
+
| # | 常量名 | Android导出 | iOS导出 | ArkTS TurboModule导出 | ArkTS文件:行号 | 完整性 | 扣分 |
|
|
518
|
+
|---|--------|-----------|---------|----------------------|---------------|--------|------|
|
|
519
|
+
| 1 | `Scale` | ✅ | ✅ | ✅ | `MapsTurboModule.ets:25` | ✅ 三平台一致 | 0 |
|
|
520
|
+
| 2 | `ConnectionPriority` | ✅ | ⛔ 无 | ⛔ 无 | — | ⚠️ 仅Android有 | -5 |
|
|
521
|
+
```
|
|
522
|
+
|
|
523
|
+
##### 检查项5:常量值一致性
|
|
524
|
+
|
|
525
|
+
- **检查项**: 常量值一致性
|
|
526
|
+
- **特征检索方式**: 在各平台 TurboModule 文件中读取 `getConstants()` 返回的常量值
|
|
527
|
+
- **检视步骤**:
|
|
528
|
+
1. 从各平台 `getConstants()` 方法中提取常量的具体值
|
|
529
|
+
2. 对每个共有常量,对比 Android值 vs iOS值 vs ArkTS TurboModule值
|
|
530
|
+
3. 判定规则:值完全一致→通过;值不一致→标注差异并扣分
|
|
531
|
+
- **扣分规则**: 值不一致→轻微-3分/个
|
|
532
|
+
- **输出格式**:
|
|
533
|
+
|
|
534
|
+
```markdown
|
|
535
|
+
| # | 常量名 | Android值 | iOS值 | ArkTS TurboModule值 | 值一致性 | 扣分 |
|
|
536
|
+
|---|--------|---------|-------|--------------------|---------|------|
|
|
537
|
+
| 1 | `Scale` | `0.0001` | `0.0001` | `0.0001` | ✅ | 0 |
|
|
538
|
+
| 2 | `Timeout` | `30` | `30` | `60` | ❌ | -3 |
|
|
539
|
+
```
|
|
540
|
+
|
|
541
|
+
#### ②平台实现差异
|
|
542
|
+
|
|
543
|
+
##### 检查项6:返回值vs Android/iOS
|
|
544
|
+
|
|
545
|
+
- **检查项**: 返回值vs Android/iOS
|
|
546
|
+
- **特征检索方式**: 在 Android/iOS TurboModule 文件中读取方法返回值;在 `*TurboModule.ets` 中读取方法返回值
|
|
547
|
+
- **检视步骤**:
|
|
548
|
+
1. 从 `*TurboModule.ets` 提取每个方法的返回值类型和语义
|
|
549
|
+
2. 从 Android/iOS TurboModule 提取对应方法的返回值类型和语义
|
|
550
|
+
3. 对比 ArkTS返回值 vs Android/iOS返回值
|
|
551
|
+
4. 判定规则:差异合并至①契约一致性检查,不独立扣分;Android/iOS返回值差异视为JS Spec返回值对比的补充参考
|
|
552
|
+
- **扣分规则**: 差异合并至①检查,不独立扣分
|
|
553
|
+
- **输出格式**:
|
|
554
|
+
|
|
555
|
+
```markdown
|
|
556
|
+
| # | 方法名 | ArkTS TurboModule返回值 | Android返回值 | iOS返回值 | 差异 | 合并至①检查项 |
|
|
557
|
+
|---|--------|------------------------|-------------|---------|------|-------------|
|
|
558
|
+
| 1 | `isFileUploadSupported` | `Promise<boolean>` | `boolean` | `BOOL` | ✅ 功能一致 | — |
|
|
559
|
+
```
|
|
560
|
+
|
|
561
|
+
#### ③架构桥接一致性
|
|
562
|
+
|
|
563
|
+
> ③架构桥接一致性维度已由①契约一致性检查覆盖(Spec接口实现已在3.1检查点9中完成),此处不再重复。
|
|
564
|
+
|
|
565
|
+
---
|
|
566
|
+
|
|
567
|
+
### 3.3 检查点:实现逻辑 ⚠️ 最关键检查项
|
|
568
|
+
|
|
569
|
+
#### 检查项概要
|
|
570
|
+
|
|
571
|
+
| # | 检查项 | 维度 | 对比对象 | 扣分规则 | 致命度 |
|
|
572
|
+
|---|--------|------|----------|----------|--------|
|
|
573
|
+
| 1 | Stub检测与合理性判定 | ②平台实现差异⚠️核心 | ArkTS方法实现 vs Android/iOS同名方法行为 | 致命Stub→-8分/方法;空方法体→-8分/方法;逻辑Stub→-12分/方法;合理Stub→0分 | 致命/严重/0 |
|
|
574
|
+
| 2 | 方法行为跨平台对比 | ②平台实现差异⚠️核心 | Android/iOS/OHOS三平台方法行为 | 行为致命不一致→-15分/方法;行为严重不一致→-12分/方法 | 致命/严重 |
|
|
575
|
+
| 3 | 边界处理 | ②平台实现差异 | ArkTS方法边界条件 vs Android/iOS边界处理 | 不一致→-8分 | 中等 |
|
|
576
|
+
| 4 | 错误处理 | ②平台实现差异 | ArkTS方法错误处理 vs Android/iOS错误处理 | 不一致→-6分 | 中等 |
|
|
577
|
+
| 5 | 回调/事件机制 | ③架构桥接一致性 | ArkTS回调触发逻辑 vs Android/iOS回调触发逻辑 | 触发逻辑不一致→-12分/个 | 严重 |
|
|
578
|
+
| — | ①契约一致性 | — | 实现逻辑不属于契约维度,N/A | — | — |
|
|
579
|
+
|
|
580
|
+
#### ①契约一致性
|
|
581
|
+
|
|
582
|
+
> 实现逻辑不属于契约维度(契约维度仅覆盖签名和返回值声明),①为 N/A。
|
|
583
|
+
|
|
584
|
+
#### ②平台实现差异 ⚠️ 核心维度:每个方法与Android/iOS行为级对比
|
|
585
|
+
|
|
586
|
+
##### 检查项1:Stub检测与合理性判定
|
|
587
|
+
|
|
588
|
+
- **检查项**: Stub检测与合理性判定
|
|
589
|
+
- **特征检索方式**: 在 `*TurboModule.ets` 中查找以下Stub模式:(a) `return true;` / `return false;` / `return null;` 等固定返回值;(b) `return Promise.resolve(true)` / `return Promise.resolve(false)` 等固定Promise返回;(c) 方法体仅有 `console.log` 或注释;(d) 方法体为空或仅有 `{}`;(e) 未调用任何 `@ohos` API 或实际业务操作
|
|
590
|
+
- **检视步骤**:
|
|
591
|
+
1. 读取 `*TurboModule.ets` 中每个方法的方法体
|
|
592
|
+
2. 识别Stub模式:(a) 方法体仅有return固定值;(b) 未调用@ohos API;(c) 未执行实际业务操作;(d) 仅console.log输出
|
|
593
|
+
3. 读取 Android Java/Kotlin TurboModule 中同名方法的实际实现
|
|
594
|
+
4. 读取 iOS TurboModule 中同名方法的实际实现
|
|
595
|
+
5. 对比:Android/iOS有实际业务逻辑但ArkTS为Stub→致命Stub;iOS也返回固定值→合理Stub
|
|
596
|
+
6. 判定规则:三平台行为一致(均为固定返回)→合理Stub 0分;Android/iOS有实际逻辑但ArkTS为Stub→致命Stub 扣分
|
|
597
|
+
- **扣分规则**:
|
|
598
|
+
- 合理固定返回:方法语义本身返回固定值且与Android/iOS一致→0分
|
|
599
|
+
- 无条件Stub:返回固定值但Android/iOS有实际业务逻辑→致命-8分/方法
|
|
600
|
+
- 空方法体Stub:方法体为空或仅有console.log→致命-8分/方法
|
|
601
|
+
- 逻辑Stub:有部分逻辑但缺少核心操作→严重-12分/方法
|
|
602
|
+
- **输出格式**:
|
|
603
|
+
|
|
604
|
+
```markdown
|
|
605
|
+
| # | 方法名 | ArkTS文件:行号 | Stub代码片段 | Stub类型 | Android实现 | iOS实现 | Stub合理性 | 缺失逻辑 | 严重度 | 扣分 |
|
|
606
|
+
|---|--------|---------------|-------------|---------|------------|--------|-----------|---------|--------|------|
|
|
607
|
+
| 1 | `isFileUploadSupported` | `WebViewTurboModule.ets:14` | `return Promise.resolve(true)` | 合理固定返回 | ✅ Android5+返回true | ✅ 始终返回YES | ✅ 三平台一致 | 无 | ⚠️ 合理 | 0 |
|
|
608
|
+
| 2 | `removeBond` | `BleTurboModule.ets:278` | `return true;` | 无条件Stub | ✅ 调用BluetoothDevice.removeBond() | ✅ 调用CBCentralManager.remove() | ❌ 缺失实际解绑 | 实际解绑操作 | ❌ 致命 | -8 |
|
|
609
|
+
| 3 | `requestPriority` | `BleTurboModule.ets:455` | `// todo: implement` | 空方法体Stub | ✅ 调用gatt.requestConnectionPriority() | ⛔ 不支持 | ❌ 空方法体 | 优先级请求 | ❌ 致命 | -8 |
|
|
610
|
+
| 4 | `connect` | `BleTurboModule.ets:89` | 仅更新状态变量未调用蓝牙连接 | 逻辑Stub | ✅ 调用BluetoothGatt.connect() | ✅ 调用CBCentralManager.connect() | ❌ 缺少核心操作 | 蓝牙连接API调用 | ❌ 严重 | -12 |
|
|
611
|
+
```
|
|
612
|
+
|
|
613
|
+
##### 检查项2:方法行为跨平台对比
|
|
614
|
+
|
|
615
|
+
- **检查项**: 方法行为跨平台对比
|
|
616
|
+
- **特征检索方式**: 在 Android/iOS/ArkTS 三平台 TurboModule 文件中读取每个方法的实现摘要
|
|
617
|
+
- **检视步骤**:
|
|
618
|
+
1. 对每个TurboModule方法,读取Android实现并提取行为摘要(调用的API、执行的操作、产生的结果)
|
|
619
|
+
2. 读取iOS实现并提取行为摘要
|
|
620
|
+
3. 读取ArkTS TurboModule实现并提取行为摘要
|
|
621
|
+
4. 对比三平台实际行为:核心业务逻辑是否一致、副作用是否一致、结果是否等效
|
|
622
|
+
5. 判定规则:三平台行为一致或功能等效→通过;行为致命不一致→致命扣分;行为严重不一致→严重扣分
|
|
623
|
+
- **扣分规则**:
|
|
624
|
+
- 行为致命不一致(核心功能缺失或行为完全不同)→致命-15分/方法
|
|
625
|
+
- 行为严重不一致(部分核心逻辑缺失)→严重-12分/方法
|
|
626
|
+
- **输出格式**:
|
|
627
|
+
|
|
628
|
+
```markdown
|
|
629
|
+
| # | 方法名 | Android实现摘要 | iOS实现摘要 | ArkTS实现摘要 | ArkTS文件:行号 | 行为对比状态 | 扣分 |
|
|
630
|
+
|---|--------|---------------|------------|--------------|---------------|------------|------|
|
|
631
|
+
| 1 | `isFileUploadSupported` | ✅ Android5+返回true | ✅ 始终返回YES | ✅ 始终返回true | `WebViewTurboModule.ets:14` | ✅ 三平台一致 | 0 |
|
|
632
|
+
| 2 | `connect` | ✅ 调用BluetoothGatt.connect() | ✅ 调用CBCentralManager.connect() | ✅ 调用@ohos.bluetooth.ble.connect() | `BleTurboModule.ets:89` | ✅ 功能一致 | 0 |
|
|
633
|
+
| 3 | `removeBond` | ✅ 调用BluetoothDevice.removeBond() | ✅ 调用CBCentralManager.remove() | ❌ Stub: return true | `BleTurboModule.ets:278` | ❌ 致命不一致 | -15 |
|
|
634
|
+
```
|
|
635
|
+
|
|
636
|
+
##### 检查项3:边界处理
|
|
637
|
+
|
|
638
|
+
- **检查项**: 边界处理
|
|
639
|
+
- **特征检索方式**: 在 `*TurboModule.ets` 中查找边界条件处理代码(null/undefined检查、空数组检查、越界检查等);在 Android/iOS TurboModule 中查找同名方法的边界条件处理
|
|
640
|
+
- **检视步骤**:
|
|
641
|
+
1. 从 `*TurboModule.ets` 读取每个方法的边界条件处理(null检查、空值检查、参数校验等)
|
|
642
|
+
2. 从 Android/iOS TurboModule 读取同名方法的边界条件处理
|
|
643
|
+
3. 对比 ArkTS边界处理 vs Android/iOS边界处理
|
|
644
|
+
4. 判定规则:边界处理一致或ArkTS有更严格的处理→通过;不一致→标注并扣分
|
|
645
|
+
- **扣分规则**: 不一致→中等-8分
|
|
646
|
+
- **输出格式**:
|
|
647
|
+
|
|
648
|
+
```markdown
|
|
649
|
+
| # | 方法名 | Android/iOS边界处理 | ArkTS TurboModule边界处理 | 一致性 | 扣分 |
|
|
650
|
+
|---|--------|-------------------|-------------------------|--------|------|
|
|
651
|
+
| 1 | `connect` | ✅ 检查id非null | ✅ 检查id非null和非空字符串 | ✅ ArkTS更严格 | 0 |
|
|
652
|
+
| 2 | `startScan` | ✅ 检查filter非null | ❌ 无边界检查 | ❌ | -8 |
|
|
653
|
+
```
|
|
654
|
+
|
|
655
|
+
##### 检查项4:错误处理
|
|
656
|
+
|
|
657
|
+
- **检查项**: 错误处理
|
|
658
|
+
- **特征检索方式**: 在 `*TurboModule.ets` 中查找 try-catch 块、error回调、Promise.reject 等错误处理模式;在 Android/iOS TurboModule 中查找同名方法的错误处理
|
|
659
|
+
- **检视步骤**:
|
|
660
|
+
1. 从 `*TurboModule.ets` 读取每个方法的错误处理(try-catch、error callback、Promise.reject等)
|
|
661
|
+
2. 从 Android/iOS TurboModule 读取同名方法的错误处理
|
|
662
|
+
3. 对比 ArkTS错误处理 vs Android/iOS错误处理
|
|
663
|
+
4. 判定规则:错误处理一致或ArkTS有合理的错误处理→通过;不一致→标注并扣分
|
|
664
|
+
- **扣分规则**: 不一致→中等-6分
|
|
665
|
+
- **输出格式**:
|
|
666
|
+
|
|
667
|
+
```markdown
|
|
668
|
+
| # | 方法名 | Android/iOS错误处理 | ArkTS TurboModule错误处理 | 一致性 | 扣分 |
|
|
669
|
+
|---|--------|-------------------|-------------------------|--------|------|
|
|
670
|
+
| 1 | `connect` | ✅ try-catch + Promise.reject | ✅ try-catch + Promise.reject | ✅ | 0 |
|
|
671
|
+
| 2 | `readRSSI` | ✅ try-catch + 回调error参数 | ❌ 无错误处理 | ❌ | -6 |
|
|
672
|
+
```
|
|
673
|
+
|
|
674
|
+
#### ③架构桥接一致性
|
|
675
|
+
|
|
676
|
+
##### 检查项5:回调/事件机制
|
|
677
|
+
|
|
678
|
+
- **检查项**: 回调/事件机制
|
|
679
|
+
- **特征检索方式**: 在 `*TurboModule.ets` 中 grep 回调调用模式(`this.emitDeviceEvent`、`sendEvent`、回调函数调用);在 Android/iOS TurboModule 中 grep 同名回调触发模式(Android: `sendEvent`/回调接口;iOS: `RCTEventEmitter`/block回调)
|
|
680
|
+
- **检视步骤**:
|
|
681
|
+
1. 从 `*TurboModule.ets` 读取每个回调方法的触发逻辑(触发时机、触发方式、回调参数)
|
|
682
|
+
2. 从 Android TurboModule 读取同名回调/事件的触发逻辑
|
|
683
|
+
3. 从 iOS TurboModule 读取同名回调/事件的触发逻辑
|
|
684
|
+
4. 对比 ArkTS回调触发逻辑 vs Android/iOS回调触发逻辑
|
|
685
|
+
5. 判定规则:触发时机、触发方式、回调参数三平台一致→通过;触发逻辑不一致→标注并扣分
|
|
686
|
+
- **扣分规则**: 触发逻辑不一致→严重-12分/个
|
|
687
|
+
- **输出格式**:
|
|
688
|
+
|
|
689
|
+
```markdown
|
|
690
|
+
| # | 回调/事件名 | JS Spec定义 | Android触发逻辑 | iOS触发逻辑 | ArkTS TurboModule触发逻辑 | ArkTS文件:行号 | 触发逻辑一致性 | 扣分 |
|
|
691
|
+
|---|------------|-------------|---------------|------------|-------------------------|---------------|--------------|------|
|
|
692
|
+
| 1 | `shouldStartLoadWithLockIdentifier` | `(shouldStart: boolean, lockIdentifier: Double): void` | ✅ AtomicReference + notify | ✅ DecisionManager setResult | ✅ ShouldStartParams + lockState | `WebViewTurboModule.ets:18` | ✅ 功能一致 | 0 |
|
|
693
|
+
| 2 | `onBluetoothStateChange` | `event: {state: string}` | ✅ sendEvent("onBluetoothStateChange", {state}) | ✅ RCTEventEmitter | ⛔ 未发送事件 | — | ❌ 事件缺失 | -12 |
|
|
694
|
+
```
|
|
695
|
+
|
|
696
|
+
---
|
|
697
|
+
|
|
698
|
+
## 4. 方法行为跨平台对比
|
|
699
|
+
|
|
700
|
+
### 4.1 方法行为对比格式
|
|
701
|
+
|
|
702
|
+
对每个 TurboModule 方法,必须与 Android/iOS 的同名方法做行为对比:
|
|
703
|
+
|
|
704
|
+
```markdown
|
|
705
|
+
| # | 方法名 | Android 实现摘要 | iOS 实现摘要 | ArkTS TurboModule 实现摘要 | ArkTS 文件:行号 | 行为对比状态 | 扣分 |
|
|
706
|
+
|---|--------|----------------|-------------|--------------------------|---------------|------------|------|
|
|
707
|
+
| 1 | `isFileUploadSupported` | ✅ Android 5+ 返回 true | ✅ 始终返回 YES | ✅ 始终返回 true | `WebViewTurboModule.ets:14` | ✅ 三平台一致 | 0 |
|
|
708
|
+
| 2 | `connect` | ✅ 调用 BluetoothGatt.connect() | ✅ 调用 CBCentralManager.connect() | ✅ 调用 @ohos.bluetooth.ble.connect() | `BleTurboModule.ets:89` | ✅ 功能一致 | 0 |
|
|
709
|
+
| 3 | `removeBond` | ✅ 调用 BluetoothDevice.removeBond() | ✅ 调用 CBCentralManager.remove() | ❌ Stub: `return true;` | `BleTurboModule.ets:278` | ❌ 致命不一致 | -8 |
|
|
710
|
+
```
|
|
711
|
+
|
|
712
|
+
### 4.2 行为一致性判定规则
|
|
713
|
+
|
|
714
|
+
| 行为对比结果 | 判定 | 扣分 |
|
|
715
|
+
|-------------|------|------|
|
|
716
|
+
| 三平台行为一致 | ✅ 一致 | 0 |
|
|
717
|
+
| OHOS 使用不同机制但功能等效 | ✅ 功能一致 | 0 |
|
|
718
|
+
| OHOS 仅缺少非核心差异 | ⚠️ 轻微不一致 | -3~-5 |
|
|
719
|
+
| OHOS 缺少部分核心逻辑 | ❌ 严重不一致 | -8~-12 |
|
|
720
|
+
| OHOS 为 Stub 或方法缺失 | ❌ 致命 | -8~-15 |
|
|
721
|
+
|
|
722
|
+
---
|
|
723
|
+
|
|
724
|
+
## 5. 跨层一致性检测(ArkTS TurboModule 视角)
|
|
725
|
+
|
|
726
|
+
### 5.1 全链路 TurboModule 对比
|
|
727
|
+
|
|
728
|
+
```markdown
|
|
729
|
+
| # | TurboModule 名 | JS Spec 定义 | JS Spec 注册名 | C++ FactoryDelegate 注册名 | C++ JSIBinder | generated Spec 接口 | ArkTS TurboModule 类 | ArkTS 文件 | 状态 | 扣分 |
|
|
730
|
+
|---|--------------|------------|--------------|------------------------|-------------|--------------------|--------------------|-----------|------|------|
|
|
731
|
+
| 1 | `RNCWebViewModule` | `NativeRNCWebViewModule.ts` | `RNCWebViewModule` | ✅ `RNCWebViewModule` | ✅ JSIBinder | ✅ TM.RNCWebViewModule.Spec | ✅ WebViewTurboModule | `WebViewTurboModule.ets:11` | ✅ 全链路一致 | 0 |
|
|
732
|
+
```
|
|
733
|
+
|
|
734
|
+
### 5.2 断桥类型定义(TurboModule 视角)
|
|
735
|
+
|
|
736
|
+
| 断桥位置 | 识别方式 | 影响 | 扣分 |
|
|
737
|
+
|---------|----------|------|------|
|
|
738
|
+
| JS→C++ 注册断桥 | JS Spec TurboModuleRegistry 注册名在 C++ FactoryDelegate 中无对应 if 条件 | JS 调用 TurboModule 但 C++ 无法创建实例 | -10/个(致命) |
|
|
739
|
+
| C++→ArkTS 类映射断桥 | C++ FactoryDelegate 中 `std::make_shared<XxxTurboModule>` 类名在 ArkTS 中无对应实现类 | C++ 创建实例但无法路由到 ArkTS 实现 | -8/个(严重) |
|
|
740
|
+
| ArkTS 方法缺失断桥 | JS Spec 方法在 ArkTS TurboModule 中无对应方法实现 | JS 调用方法但 ArkTS 不响应 | -15/个(致命) |
|
|
741
|
+
| ArkTS Stub 断桥 | ArkTS TurboModule 方法为 Stub 但 Android/iOS 有实际业务逻辑 | 方法调用成功但行为完全不同 | -8/方法(致命) |
|
|
742
|
+
| ArkTS 常量缺失断桥 | Android/iOS getConstants() 导出的常量在 ArkTS TurboModule 中缺失 | JS 读取常量返回 undefined | -5/个(中等) |
|
|
743
|
+
|
|
744
|
+
---
|
|
745
|
+
|
|
746
|
+
## 6. 检视操作流程
|
|
747
|
+
|
|
748
|
+
### 6.1 Phase 0 补充步骤(ArkTS TurboModule 定位)
|
|
749
|
+
|
|
750
|
+
```
|
|
751
|
+
TM-ARK-1: 定位 ArkTS TurboModule 实现文件
|
|
752
|
+
→ 搜索 harmony/<module>/src/main/ets/*TurboModule.ets
|
|
753
|
+
|
|
754
|
+
TM-ARK-2: 定位 generated TurboModule Spec 类型
|
|
755
|
+
→ 搜索 generated/turboModules/TurboModuleName.ts
|
|
756
|
+
→ 搜索 generated/turboModules/ts.ts
|
|
757
|
+
|
|
758
|
+
TM-ARK-3: 读取 ArkTS TurboModule 类声明
|
|
759
|
+
→ 提取 NAME 常量、父类、implements Spec 接口
|
|
760
|
+
|
|
761
|
+
TM-ARK-4: 读取 generated Spec 接口方法列表
|
|
762
|
+
→ 提取所有方法名和签名
|
|
763
|
+
```
|
|
764
|
+
|
|
765
|
+
### 6.2 Phase 3 补充步骤(ArkTS TurboModule 分析)
|
|
766
|
+
|
|
767
|
+
```
|
|
768
|
+
TM-ARK-5: TurboModule NAME 常量对比
|
|
769
|
+
→ ArkTS NAME 常量 vs JS Spec TurboModuleRegistry 注册名 vs C++ FactoryDelegate 注册名
|
|
770
|
+
→ 标注注册名不一致
|
|
771
|
+
|
|
772
|
+
TM-ARK-6: 方法实现完整性对比
|
|
773
|
+
→ JS Spec 方法名 vs generated Spec 方法名 vs ArkTS TurboModule 方法名
|
|
774
|
+
→ 标注方法缺失
|
|
775
|
+
|
|
776
|
+
TM-ARK-7: 方法签名对比
|
|
777
|
+
→ ArkTS TurboModule 方法签名 vs generated Spec 接口方法签名
|
|
778
|
+
→ 标注签名不匹配、类型映射错误
|
|
779
|
+
|
|
780
|
+
TM-ARK-8: Stub 检测与合理性判定
|
|
781
|
+
→ 对每个 ArkTS TurboModule 方法判断是否为 Stub
|
|
782
|
+
→ 与 Android/iOS 同名方法行为对比判定 Stub 合理性
|
|
783
|
+
→ 标注 Stub 方法及其缺失逻辑
|
|
784
|
+
|
|
785
|
+
TM-ARK-9: 常量导出对比
|
|
786
|
+
→ Android/iOS getConstants() vs ArkTS TurboModule getConstants()
|
|
787
|
+
→ 标注失常量
|
|
788
|
+
|
|
789
|
+
TM-ARK-10: 回调/事件对比
|
|
790
|
+
→ ArkTS TurboModule 回调/事件实现 vs Android/iOS 回调/事件
|
|
791
|
+
→ 标注回调缺失、事件缺失、Payload 缺失
|
|
792
|
+
|
|
793
|
+
TM-ARK-11: 方法行为跨平台对比
|
|
794
|
+
→ 对每个方法列出 Android/iOS/OHOS 三平台行为
|
|
795
|
+
→ 标注行为不一致
|
|
796
|
+
```
|
|
797
|
+
|
|
798
|
+
---
|
|
799
|
+
|
|
800
|
+
## 7. 报告输出格式
|
|
801
|
+
|
|
802
|
+
在一致性检视报告的"5.8 RN 架构一致性检视"中增加以下子章节:
|
|
803
|
+
|
|
804
|
+
```markdown
|
|
805
|
+
#### ArkTS TurboModule 层一致性(如适用)
|
|
806
|
+
|
|
807
|
+
**ArkTS TurboModule 模式**:{Codegen(implements TM.Xxx.Spec)/ Legacy(手写) / ⚠️ 无 ArkTS TurboModule 层}
|
|
808
|
+
|
|
809
|
+
**TurboModule 类声明一致性**:
|
|
810
|
+
|
|
811
|
+
| # | TurboModule 名 | ArkTS 类名 | NAME 常量 | JS Spec 注册名 | C++ FactoryDelegate | implements Spec? | 状态 | 扣分 |
|
|
812
|
+
|---|--------------|-----------|----------|--------------|--------------------|----------------|------|------|
|
|
813
|
+
| ... | ... | ... | ... | ... | ... | ... | ... | ... |
|
|
814
|
+
|
|
815
|
+
**TurboModule 方法级对比**:
|
|
816
|
+
|
|
817
|
+
| # | 方法名 | JS Spec 签名 | generated Spec 签名 | ArkTS TurboModule 签名 | ArkTS 文件:行号 | 实现状态 | 扣分 |
|
|
818
|
+
|---|--------|-------------|--------------------|----------------------|---------------|----------|------|
|
|
819
|
+
| ... | ... | ... | ... | ... | ... | ... | ... |
|
|
820
|
+
|
|
821
|
+
**TurboModule Stub 检测**:
|
|
822
|
+
|
|
823
|
+
| # | 方法名 | ArkTS 文件:行号 | Stub 代码 | Android 实现 | iOS 实现 | Stub 合理性 | 缺失逻辑 | 严重度 | 扣分 |
|
|
824
|
+
|---|--------|---------------|----------|-------------|---------|------------|---------|--------|------|
|
|
825
|
+
| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |
|
|
826
|
+
|
|
827
|
+
**TurboModule 常量导出对比**:
|
|
828
|
+
|
|
829
|
+
| # | 常量名 | Android getConstants() | iOS getConstants() | ArkTS TurboModule getConstants() | ArkTS 文件:行号 | 值一致性 | 状态 | 扣分 |
|
|
830
|
+
|---|--------|----------------------|--------------------|--------------------------------|---------------|---------|------|------|
|
|
831
|
+
| ... | ... | ... | ... | ... | ... | ... | ... | ... |
|
|
832
|
+
|
|
833
|
+
**TurboModule 回调/事件对比**:
|
|
834
|
+
|
|
835
|
+
| # | 回调/事件名 | JS Spec 定义 | Android 实现 | iOS 实现 | ArkTS TurboModule 实现 | ArkTS 文件:行号 | 行为一致性 | 扣分 |
|
|
836
|
+
|---|------------|-------------|-------------|---------|----------------------|---------------|-----------|------|
|
|
837
|
+
| ... | ... | ... | ... | ... | ... | ... | ... | ... |
|
|
838
|
+
|
|
839
|
+
**TurboModule 方法行为跨平台对比**:
|
|
840
|
+
|
|
841
|
+
| # | 方法名 | Android 实现摘要 | iOS 实现摘要 | ArkTS 实现摘要 | ArkTS 文件:行号 | 行为对比状态 | 扣分 |
|
|
842
|
+
|---|--------|----------------|-------------|--------------|---------------|------------|------|
|
|
843
|
+
| ... | ... | ... | ... | ... | ... | ... | ... |
|
|
844
|
+
```
|
|
845
|
+
|
|
846
|
+
---
|
|
847
|
+
|
|
848
|
+
## 8. 与 CPP_TURBOMODULE_CHECK_GUIDE 的协同
|
|
849
|
+
|
|
850
|
+
本指南与 CPP_TURBOMODULE_CHECK_GUIDE 共享"TurboModule 全链路对比表"。检视执行顺序建议:
|
|
851
|
+
|
|
852
|
+
1. **先执行 CPP_TURBOMODULE_CHECK_GUIDE** → 获得 C++ FactoryDelegate 注册名、JSIBinder 方法列表
|
|
853
|
+
2. **再执行 ARKTS_TURBOMODULE_CHECK_GUIDE** → 获得 ArkTS TurboModule 类声明、方法实现、Stub 检测、常量导出、回调/事件数据
|
|
854
|
+
3. **合并两张表** → 生成完整 TurboModule 全链路一致性分析
|
|
855
|
+
|
|
856
|
+
若两个指南独立执行,各自的全链路表可能存在重叠列。合并时以 TurboModule 名为主键,将两表的列拼接为完整链路。
|