HarmonyOS 鸿蒙Next中集成HMS Core SDK

HarmonyOS 鸿蒙Next中集成HMS Core SDK

集成HMS Core SDK

添加当前应用的AppGallery Connect配置文件

如果在AppGallery Connect中开通了相关服务则需要将“agconnect-services.json”文件添加到您的App中。

  1. 登录AppGallery Connect网站,点击“我的项目”。
  2. 在项目列表中找到您的项目,在项目中点击需要集成HMS Core SDK的应用。
  3. 在“项目设置 > 常规”页面的“应用”区域,点击“agconnect-services.json”下载配置文件。
  4. 将“agconnect-services.json”文件拷贝到应用级根目录下。

配置HMS Core SDK的Maven仓地址

Android Studio的代码库配置在Gradle插件7.0以下版本、7.0版本和7.1及以上版本有所不同。请根据您当前的Gradle插件版本,选择对应的配置过程。

版本 描述
7.0以下版本 打开Android Studio项目级“build.gradle”文件。
添加HUAWEI AGC插件以及Maven代码库。
在“buildscript > repositories”中配置HMS Core SDK的Maven仓地址。
在“allprojects > repositories”中配置HMS Core SDK的Maven仓地址。
7.0版本 打开Android Studio项目级“build.gradle”文件。
添加HUAWEI AGC插件以及Maven代码库。
在“buildscript > repositories”中配置HMS Core SDK的Maven仓地址。
在“buildscript > dependencies”中增加Android Gradle插件配置。
如果App中添加了“agconnect-services.json”文件,则还需要在“buildscript > dependencies”中增加AGC插件。
打开项目级“settings.gradle”文件,配置HMS Core SDK的Maven仓地址。
7.1及以上版本 打开Android Studio项目级“build.gradle”文件。
在“buildscript > dependencies”中增加Android Gradle插件配置。如果App中添加了“agconnect-services.json”文件,则还需要在“buildscript > dependencies”中增加AGC插件。
打开项目级“settings.gradle”文件,配置HMS Core SDK的Maven仓地址。

说明:Maven仓地址无法直接在浏览器中打开访问,只能在IDE中配置。如需添加多个Maven代码库,请将华为公司的Maven仓地址配置在最后。

添加编译依赖

  1. 打开应用级的“build.gradle”文件。
  2. 在“dependencies”中添加如下编译依赖。

音频编辑UI SDK

dependencies{
    implementation 'com.huawei.hms:audio-editor-ui:{version}'
}

音频编辑原子能力SDK

dependencies{
    implementation 'com.huawei.hms:audio-editor-sdk:{version}'
}

音频编辑AI配音SDK

dependencies{
    implementation 'com.huawei.hms:audio-editor-aidubbing:{version}'
}

音频编辑音源分离SDK

dependencies{
    implementation 'com.huawei.hms:audio-editor-separation:{version}'
}

说明:{version}需要替换为实际的SDK版本号,版本号索引请参见版本更新说明。例如:implementation 'com.huawei.hms:audio-editor-ui:1.1.0.300'

  1. 添加agcp插件配置。请根据实际情况选择:
  • 方式一:在文件头部声明添加如下配置。
    apply plugin: 'com.huawei.agconnect'
    
  • 方式二:在plugins中添加如下配置。
    plugins {
        id 'com.android.application'
        // 添加如下配置
        id 'com.huawei.agconnect'
    }
    
  1. 配置NDK过滤项,目前Audio Editor SDK只支持arm64-v8a和armeabi-v7,暂不支持x86和x86_64。
    defaultConfig {
        ndk {
            abiFilters 'arm64-v8a', 'armeabi-v7a'
        }
    }
    

多语言设置

如果您的应用不需要设置只支持某些特定语言,则请忽略本步骤。应用将默认支持所有HMS Core SDK支持的语言。

如果您的应用需要设置只支持某些特定语言,则可通过本步骤配置。

  1. 打开应用级的“build.gradle”文件。
  2. 在“android > defaultConfig”中新增“resConfigs”,配置需要支持的语种,配置格式如下:
    android {
        defaultConfig {
            ...
            resConfigs "en", "zh-rCN", "<需要支持的其他语言>"
        }
    }
    

HMS Core SDK支持的语言列表请参见HMS Core SDK支持的语言

同步工程

在完成以上的配置后,点击工具栏中的gradle同步图标,完成“build.gradle”文件的同步,将相关依赖下载到本地。

说明:如果出现错误,请检查网络连接是否正常,以及检查“build.gradle”文件是否正确。


更多关于HarmonyOS 鸿蒙Next中集成HMS Core SDK的实战教程也可以访问 https://www.itying.com/category-93-b0.html

1 回复

更多关于HarmonyOS 鸿蒙Next中集成HMS Core SDK的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS Next中集成HMS Core SDK,首先需在项目中添加HMS Core依赖。通过ohpmnpm安装HMS Core SDK包,例如@ohos/hmscore。然后在module.json5中配置所需权限和HMS Core服务。接着在代码中初始化HMS Core,并调用相关API实现功能,如地图、推送等。确保在华为开发者联盟注册应用并获取agconnect-services.json配置文件,将其放置于项目resources目录下。最后,编译运行应用,验证HMS Core功能是否正常集成。

回到顶部