integrateShareTrace

集成ShareTrace分享到Android项目，自动配置相关文件和依赖。

前置依赖

依赖参数

参数名	类型	说明
deps.existsSync	FileSystem['existsSync']	检查文件是否存在
deps.readFileSync	FileSystem['readFileSync']	读取文件内容
deps.writeFileSync	FileSystem['writeFileSync']	写入文件内容
deps.copyFileSync	FileSystem['copyFileSync']	复制文件
deps.join	Path['join']	路径拼接
deps.xmlParser	XMLParserConstructor	XML 解析器构造函数
deps.xmlSerializer	XMLSerializerConstructor	XML 序列化器构造函数
deps.xpath	XPath	XPath 查询库

环境要求

• @xmldom/xmldom: XML DOM 解析库
• xpath: XPath 查询库

npm install @xmldom/xmldom xpath

函数签名

function integrateShareTrace(
  projectPath: string,
  moduleDir: string,
  packageName: string,
  config: ShareTraceConfig,
  deps: IntegrateThirdPartyModuleDeps
): Promise<{ success: boolean; message?: string; error?: string; logs: string[] }>

interface ShareTraceConfig {
  appKey: string  // ShareTrace AppKey（从ShareTrace控制台获取）
}

参数

参数名	类型	必填	说明
projectPath	string	是	Android项目路径
moduleDir	string	是	模块目录（如 'app' 或 'HBuilder-uniPlugin'）
packageName	string	是	应用包名
config.appKey	string	是	ShareTrace AppKey
deps	IntegrateThirdPartyModuleDeps	是	依赖注入对象

返回值

类型	说明
Promise<{ success: boolean; message?: string; error?: string; logs: string[] }>	Promise，解析为集成结果对象

工作原理

1. 确保Maven仓库：在项目根目录的build.gradle中确保有mavenCentral仓库
2. 添加Gradle依赖：添加ShareTrace SDK依赖
3. 配置AndroidManifest.xml：添加ShareTrace AppKey配置
4. 配置dcloud_properties.xml：添加ShareTrace功能配置

基于 integrateThirdPartyModule 实现，自动处理依赖添加和配置文件修改，确保ShareTrace分享功能正确集成。