HarmonyOS Developer DevEco Studio使用指南-端云一体化开发
部署云工程
您也可选择在云函数和云数据库全部开发完成后,将整个云工程资源统一部署到AGC控制台。
- 右击云开发工程(“CloudProgram”),选择“Deploy Cloud Program”。
- “Event Log”区域可查看云工程打包与部署状态日志。
请您耐心等待,直至出现“Deploy succeed”日志,表示云工程已成功部署。
- 登录AppGallery Connect,分别进入当前项目的云函数与云数据库服务菜单,可查看到您刚刚部署的云函数与云数据库资源。
端云一体化组件
概述
DevEco Studio还为您提供多种端云一体化组件。集成端云一体化组件后,您只需进行简单配置即可向应用用户提供登录、支付等众多功能。
组件 | 说明 |
登录 | 集成登录组件后,可向应用用户提供登录和登出功能。 |
其他 | 敬请期待…… |
登录组件
说明
通用云开发模板目前仅支持手机验证码登录。
您可使用端云一体化登录组件向应用用户提供登录和登出功能,目前支持帐号密码登录、手机验证码登录、以及邮箱验证码登录。
组件基于ArkUI开发,提供登录对话框页面。当前仅支持基于TS扩展的声明式开发范式,您可在项目中通过npm包依赖方式引入。
前提条件
- 您的项目基于TS扩展的声明式开发范式开发。
- 您已在AGC控制台创建项目。
操作步骤
- 通过npm包依赖方式引入组件,在package.json文件中新增依赖:
"@ohos/agc-auth-component": "^1.0.0"
- 在代码中集成组件。
Column() {
Login({
modes: [AuthMode.PASSWORD, AuthMode.PHONE_VERIFY_CODE, AuthMode.MAIL_VERIFY_CODE],
apiKey: this.apiKey,
clientSecret: this.clientSecret,
onSuccess: (user) => {
AlertDialog.show({
title: 'authInfo',
message: JSON.stringify(user)
})
}
}){
Text('Login').decoration({ type: TextDecorationType.Underline })
}
}
- 需传入您的项目的ClientSecret和apiKey、以及需要开启的认证方式。
参数 | 类型 | 说明 |
modes | AuthMode | 需要开启的认证类型。当前支持手机验证码登录(PHONE_VERIFY_CODE)、邮箱验证码登录(MAIL_VERIFY_CODE)和帐号密码登录(PASSWORD)。 |
apiKey | String | 项目的API密钥,可在AGC控制台的“项目设置 > 常规”页面获取。 |
clientSecret | String | 项目的Client Secret,可在AGC控制台的“项目设置 > 常规”页面获取。 |
onSuccess | Function | 登录/注册成功后的回调函数,回调参数:userInfo(用户信息) |
onError | Function | 登录/注册失败后的回调函数,回调参数:error(错误信息) |
- 可自定义组件样式为文字、按钮或图标,点击后弹出登录弹框。
AGC应用管理
(可选)在AGC控制台创建同包名应用
如创建工程时,发现尚未在AGC控制台创建与工程包名相同的应用,可进行补充创建。
- 点击界面提示内的“AppGallery Connect”,浏览器打开AGC控制台“我的项目”页面。
- 点击选择您希望创建应用的项目,或者点击“添加项目”新建一个项目。
- 如选择了新建一个项目,设置项目名称,点击“确认”。
如选择了已有项目,则忽略此步骤。
- 设置或管理项目数据处理位置,完成后点击“下一步”。
注意
启用的数据处理位置必须包含中国站点。
- 如项目尚未设置数据处理位置,点击“启用”进行设置,具体设置规则与方法可参考设置数据处理位置。
- 如项目已设置过数据处理位置,可点击“管理”进行修改,具体规则与方法可参考管理数据处理位置。
- 进入创建应用页面,填写应用信息。
参数 | 说明 |
选择平台 | 默认选中“APP(HarmonyOS)”,其他平台不可选。 |
支持设备 | 请根据您的需求选择应用发布后运行的设备。由于API 9目前仅支持手机设备,此处请选择“手机”。 |
应用名称 | 请填写新创建的应用名称,创建成功后将获取一个新的APP ID,应用名称支持在应用信息中修改。 |
应用包名 | 从DevEco Studio中带入自动填充,且不可更改。 |
应用分类 | 请选择普通应用或游戏类应用。 说明 应用分类设置后不支持修改,请谨慎选择。 |
默认语言 | 华为应用市场客户端应用详情页中应用相关描述的默认语言。请根据实际情况选择。 |
是否原子化服务 | 确定创建的HarmonyOS应用形态。目前云开发不支持原子化服务,请选择“否”。 |
- 点击“确认”,应用创建完成。
- 点击“关闭窗口”,可在“我的项目”页面查看刚刚新建的应用,之后您即可回到HUAWEI DevEco Studio继续配置和开发您的工程。
- 点击“前往控制台”,可进入当前应用的“项目设置”菜单管理和配置您的项目和应用。
(可选)将游离应用添加到AGC项目下
游离应用指未关联任何AGC项目的应用。创建工程时,如需要关联的AGC应用为游离应用,则您需要将该应用添加到您的AGC项目下。
注意
应用与项目的关联关系一旦创建则无法再修改,请谨慎操作。
- 点击“Not associated yet”,或将鼠标悬停在应用名称前的选择按钮上、点击弹出的气泡提示内的“AppGallery Connect”,可打开AGC控制台“我的项目”页面。
- 点击选择希望为应用关联的项目,或者点击“添加项目”新建一个项目。
- 如选择了新建一个项目,设置项目名称,点击“确认”。
如选择了已有项目,则忽略此步骤。
- 设置或管理项目数据处理位置。
注意
启用的数据处理位置必须包含中国站点。
- 如项目尚未设置数据处理位置,点击“启用”进行设置,具体设置规则与方法可参考设置数据处理位置。
- 如项目已设置过数据处理位置,可点击“管理”进行修改,具体规则与方法可参考管理数据处理位置。
- 点击“确认”,应用成功关联项目。
- 点击“关闭窗口”,可在“我的项目”页面查看刚刚关联的应用,之后您即可回到HUAWEI DevEco Studio继续配置和开发您的工程。
- 点击“前往控制台”,可进入当前应用的“项目设置”菜单管理和配置您的项目和应用。