鸿蒙Next中微信的queryschemes如何配置

在鸿蒙Next系统中，如何正确配置微信的queryschemes以实现应用间跳转？具体需要修改哪些配置文件或参数？是否有需要注意的兼容性或权限问题？求详细操作步骤或示例代码。

2 回复

哎呀，鸿蒙Next里微信的queryschemes配置？简单说就是在module.json5里加个abilities的skills标签，填上微信的scheme。不过具体参数得看微信官方文档，别自己瞎编，不然微信不认账就尴尬了！

更多关于鸿蒙Next中微信的queryschemes如何配置的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在鸿蒙Next（HarmonyOS NEXT）中，配置微信的 queryschemes 需要在应用的 module.json5 文件中定义 URL Scheme，以便微信或其他应用能够通过 URL 调用你的应用。以下是详细步骤和代码示例：

步骤：

  1. 打开 module.json5 文件：位于项目的 entry/src/main/module.json5 路径下。
  2. 在 abilities 字段中配置 URL Scheme：为需要响应外部调用的 Ability（通常是 EntryAbility）添加 skills 配置，并指定 entities 和 actions，同时定义 uris 字段来声明支持的 Scheme。

代码示例：

{
  "module": {
    "name": "entry",
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ts",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true, // 确保设置为 true，允许外部应用调用
        "skills": [
          {
            "entities": ["entity.system.home"],
            "actions": ["action.system.home"],
            "uris": [
              {
                "scheme": "weixin", // 微信的 Scheme，可根据需求自定义
                "host": "your_app_host", // 可选，指定主机名
                "port": "optional_port", // 可选，指定端口
                "path": "optional_path" // 可选，指定路径
              }
            ]
          }
        ]
      }
    ]
  }
}

关键点说明：

  • scheme：设置为 weixin 或自定义值（如你的应用专属 Scheme）。微信通常使用 weixin 作为 Scheme，但实际配置需根据微信文档或你的需求调整。
  • exported：必须设为 true，否则外部应用无法调用。
  • entities 和 actions：用于标识 Ability 的类型和行为，这里使用系统主页的实体和动作作为示例，可根据实际场景修改。

处理 URL 调用：

在 Ability 的 onCreate 或 onNewWant 方法中，解析 URL 参数并处理逻辑。示例代码（TypeScript）：

import UIAbility from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    // 检查 want 中是否包含 URI 参数
    if (want.uri) {
      const uri = want.uri;
      console.log('Received URI: ' + uri); // 输出类似 "weixin://your_app_host/path?param=value"
      // 解析 URI 并执行相应操作，例如跳转到特定页面
    }
  }
}

注意事项：

  • 测试：使用 aa test 命令或 DevEco Studio 的模拟器测试 URL 调用，确保微信能正常唤醒你的应用。
  • 安全性：仅配置必要的 Scheme，避免恶意调用。
  • 微信具体集成可能涉及其他配置（如 SDK），请参考微信开放平台文档。

如果问题仅涉及配置，以上步骤即可完成；如需更复杂功能（如深度链接），可进一步扩展 URI 参数处理。

回到顶部