@harmonyos-arkts/d2h 0.1.20 → 0.1.21

package/schemas/native-libs-analysis-report.schema.json

@@ -0,0 +1,695 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://harmonyos-ai.dev/schemas/native-libs-analysis-report.schema.json",
+  "title": "d2h-native-library-analyse Migration Analysis Report",
+  "description": "analyse-android-so.py --json 的输出契约：Android .so/.a 的鸿蒙迁移分级（blocker/adaptation/clean）、障碍清单、改造点与优先级建议稿。分级是迁移成本视角，不存在『直接可用』；最终定级保留人工复核。",
+  "type": "object",
+  "required": [
+    "target",
+    "mode",
+    "tool_version",
+    "ndk1_threshold",
+    "libraries",
+    "summary"
+  ],
+  "properties": {
+    "target": {
+      "type": [
+        "string",
+        "array"
+      ],
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "mode": {
+      "enum": [
+        "project",
+        "files"
+      ]
+    },
+    "tool_version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "ndk1_threshold": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "libraries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "name",
+          "grade",
+          "priority",
+          "interface_type",
+          "grade_reasons",
+          "remediation",
+          "jni_methods",
+          "jni_dynamic_registration",
+          "summary",
+          "artifacts"
+        ],
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1
+          },
+          "grade": {
+            "enum": [
+              "blocker",
+              "adaptation",
+              "clean"
+            ]
+          },
+          "priority": {
+            "enum": [
+              "high",
+              "medium",
+              "cut-candidate",
+              "review"
+            ]
+          },
+          "interface_type": {
+            "enum": [
+              "jni",
+              "c",
+              "c++",
+              "mixed",
+              "none"
+            ]
+          },
+          "grade_reasons": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "remediation": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "jni_methods": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "symbol",
+                "class",
+                "method",
+                "overload"
+              ],
+              "properties": {
+                "symbol": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "class": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "method": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "overload": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "jni_dynamic_registration": {
+            "type": "boolean"
+          },
+          "summary": {
+            "type": "object",
+            "required": [
+              "arm64_v8a_present",
+              "archs",
+              "ndk1_defined",
+              "ndk1_undefined",
+              "static_tls",
+              "tls_relocs",
+              "android_api_symbols",
+              "dynamic_loading",
+              "emutls",
+              "libcxx_shared",
+              "unresolved",
+              "android_only",
+              "transitive_android",
+              "function_hints",
+              "build_capabilities",
+              "function_profile"
+            ],
+            "properties": {
+              "arm64_v8a_present": {
+                "type": "boolean"
+              },
+              "archs": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "ndk1_defined": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "ndk1_undefined": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "static_tls": {
+                "type": "boolean"
+              },
+              "tls_relocs": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "android_api_symbols": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "dynamic_loading": {
+                "type": "boolean"
+              },
+              "emutls": {
+                "type": "boolean"
+              },
+              "libcxx_shared": {
+                "type": "boolean"
+              },
+              "unresolved": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "android_only": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "transitive_android": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "required": [
+                    "lib",
+                    "via"
+                  ],
+                  "properties": {
+                    "lib": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "via": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              },
+              "function_hints": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "required": [
+                    "category",
+                    "count",
+                    "samples"
+                  ],
+                  "properties": {
+                    "category": {
+                      "enum": [
+                        "network",
+                        "protocols",
+                        "crypto",
+                        "crypto_algos",
+                        "media",
+                        "codecs",
+                        "formats",
+                        "compression",
+                        "hardware",
+                        "logging",
+                        "jni_signatures"
+                      ]
+                    },
+                    "count": {
+                      "type": "integer",
+                      "minimum": 1
+                    },
+                    "samples": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              },
+              "build_capabilities": {
+                "type": "object",
+                "description": "内嵌构建配置串（--enable-*）提取的能力清单：encoder/decoder/protocol/hwaccel/lib/flags",
+                "additionalProperties": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              },
+              "function_profile": {
+                "type": "string",
+                "description": "一句话功能画像（音视频编解码/网络流媒体/硬解加速/加密…），仅定性参考"
+              }
+            },
+            "additionalProperties": false
+          },
+          "artifacts": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "path",
+                "kind",
+                "arch",
+                "bits",
+                "abi_dir",
+                "soname",
+                "needed",
+                "needed_analysis",
+                "defined_total",
+                "ndk1_defined",
+                "ndk1_undefined",
+                "jni_symbols",
+                "dynamic_loading",
+                "emutls",
+                "static_tls",
+                "tls_relocs",
+                "android_api_symbols",
+                "function_hints",
+                "packaging_issues",
+                "notes",
+                "build_capabilities"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "kind": {
+                  "enum": [
+                    "so",
+                    "a",
+                    "unknown"
+                  ]
+                },
+                "arch": {
+                  "enum": [
+                    "arm64-v8a",
+                    "armeabi-v7a",
+                    "x86_64",
+                    "x86",
+                    "loongarch64",
+                    "riscv64",
+                    "unknown"
+                  ]
+                },
+                "bits": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ],
+                  "enum": [
+                    32,
+                    64,
+                    null
+                  ]
+                },
+                "abi_dir": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "soname": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "needed": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "needed_analysis": {
+                  "type": "object",
+                  "required": [
+                    "android_only",
+                    "platform",
+                    "libcxx_shared",
+                    "third_party",
+                    "unresolved"
+                  ],
+                  "properties": {
+                    "android_only": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "platform": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "libcxx_shared": {
+                      "type": "boolean"
+                    },
+                    "third_party": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    },
+                    "unresolved": {
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "minLength": 1
+                      }
+                    }
+                  },
+                  "additionalProperties": false
+                },
+                "defined_total": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "ndk1_defined": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "ndk1_undefined": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "jni_symbols": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "dynamic_loading": {
+                  "type": "boolean"
+                },
+                "emutls": {
+                  "type": "boolean"
+                },
+                "static_tls": {
+                  "type": "boolean"
+                },
+                "tls_relocs": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "android_api_symbols": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "function_hints": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": [
+                      "category",
+                      "count",
+                      "samples"
+                    ],
+                    "properties": {
+                      "category": {
+                        "enum": [
+                          "network",
+                          "protocols",
+                          "crypto",
+                          "crypto_algos",
+                          "media",
+                          "codecs",
+                          "formats",
+                          "compression",
+                          "hardware",
+                          "logging",
+                          "jni_signatures"
+                        ]
+                      },
+                      "count": {
+                        "type": "integer",
+                        "minimum": 1
+                      },
+                      "samples": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                },
+                "notes": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "source_aar": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "packaging_issues": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "description": "打包一致性：ABI 目录名与 ELF 实际架构不符、SONAME 与文件名不符"
+                },
+                "build_capabilities": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  }
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "rebuild_diffs": {
+            "type": "array",
+            "description": "--diff-against 验收基线：原 Android 产物 vs 鸿蒙重编产物的接口面 diff",
+            "items": {
+              "type": "object",
+              "required": [
+                "artifact",
+                "baseline_file",
+                "symbol_compatible",
+                "missing_jni",
+                "missing_c_symbols",
+                "missing_cpp_count",
+                "missing_cpp_samples",
+                "extra_symbol_count",
+                "missing_needed",
+                "extra_needed",
+                "note"
+              ],
+              "properties": {
+                "artifact": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "baseline_file": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "symbol_compatible": {
+                  "type": "boolean"
+                },
+                "missing_jni": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "missing_c_symbols": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "missing_cpp_count": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "missing_cpp_samples": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "extra_symbol_count": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "missing_needed": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "extra_needed": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "note": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "baseline": {
+      "type": "object",
+      "required": [
+        "path",
+        "compatible",
+        "incompatible",
+        "no_counterpart",
+        "unmatched_baseline"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "compatible": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "incompatible": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "no_counterpart": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "unmatched_baseline": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "summary": {
+      "type": "object",
+      "required": [
+        "total",
+        "blocker",
+        "adaptation",
+        "clean",
+        "order"
+      ],
+      "properties": {
+        "total": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "blocker": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "adaptation": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "clean": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "order": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}