AppGallery Connect（AGC）使用指南

一、开始使用基础准备

浏览器要求推荐使用 Google Chrome、Firefox、Microsoft Edge 浏览器访问 AGC 平台，确保兼容性和操作体验。
注册华为开发者账号

需先注册华为账号（可通过华为开发者联盟官网注册），已有账号可跳过。
完成实名认证（可选企业或个人开发者，企业开发者享更多服务）。
若涉及应用付费或内购分成，需提前开通商户服务并签署协议。

二、界面总览：新版 AGC 平台

顶部菜单

左上角 “AppGallery Connect” 图标可返回首页。
悬停左上角菜单可搜索或浏览全部服务，支持收藏常用服务（最多 8 个），近期使用的服务会显示在 “常用服务” 栏。
右上角可查看开发者账号信息、切换账号，或查看帮助文档与已签署协议。

公告版块展示平台公告（如审核安排、备案要求）和服务动态（最多各 3 条），帮助开发者及时了解平台规则更新。
导航版块提供核心功能入口：

APP：管理应用全生命周期（创建、测试、发布、升级、配置商品信息等）。
分析：查看下载、付费、优惠券活动等数据报表。
用户与访问：管理团队账号、消费详情、沙盒测试账号等。
证书、APP ID 和 Profile：申请证书、创建 HarmonyOS 应用 / 元服务、注册调试设备等。
开发与服务：使用认证服务、云函数、云测试等开发工具。

信息版块显示开发者账号信息、互动消息数量（可跳转至互动中心）、在架 / 审核中应用数量，便于快速掌握账号状态。
引导版块提供服务快捷入口，点击卡片可跳转至对应功能页面，包括：

云开发（Serverless）、云测试、应用上架、数据概览、云调试、推送服务等。
鸿蒙生态相关资源（组件 & 模板、三方 SDK、行业样板间）。

三、界面总览：旧版 AGC 平台

顶部菜单

功能与新版类似，支持返回首页、浏览全部服务、收藏常用服务，可切换至新版界面。
右上角显示账号信息，支持查看帮助文档与协议。

导航版块核心功能入口包括：

证书、APP ID 和 Profile：同新版功能。
我的元服务：管理 HarmonyOS 元服务（创建、发布等）。
我的应用：管理应用全生命周期（同新版 APP 模块）。
我的项目：使用开发服务（如云函数、云测试等）。
应用分析：查看数据报表（同新版分析模块）。
用户与访问：同新版功能。

信息版块展示互动消息、待支付订单、已购服务数量，以及最新 5 条公告和服务动态。
引导版块

提供应用发布全流程指引（从开发到运营推广）。
展示游戏解决方案的核心功能和服务，助力开发者快速接入。

四、新旧版界面切换

新版切旧版：新版界面右上角点击 “回到旧版” 即可切换。
旧版切新版：旧版界面右上角点击 “体验新版” 即可切换。

五、核心操作流程总结

注册华为账号 → 实名认证 → 开通商户服务（如需盈利）。
使用推荐浏览器登录 AGC，根据需求切换新旧版界面。
通过顶部菜单和导航版块访问开发、分发、运营等功能模块。
借助引导版块快捷入口快速进入常用服务，通过信息版块监控账号状态。
关注公告版块获取平台动态，确保应用开发与运营符合规范。

// 导入认证服务SDK
import { hilog } from **********';
import { AbilityConstant, UIAbility, Want } from **********';
import { AccountAuthService, AccountAuthParams, AccountAuthScope } from **********';
import { BusinessError } from **********';

// 在EntryAbility的onCreate中初始化认证服务
export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    hilog.info(0x0000, 'AGC', 'Ability onCreate');
  }

  // 华为帐号登录方法
  async huaweiAccountLogin() {
    try {
      // 1. 配置登录参数
      const authParams: AccountAuthParams = {
        scopes: [AccountAuthScope.OPENID] // 请求用户openid
      };

      // 2. 创建认证服务实例
      const accountAuthService = AccountAuthService.create(this.context, authParams);

      // 3. 发起登录请求
      const authResult = await accountAuthService.authorize();
      
      // 4. 处理登录结果
      if (authResult?.code === 0) {
        // 登录成功：获取用户凭证
        const accessToken = authResult.accessToken;
        const openId = authResult.openId;
        hilog.info(0x0000, 'AGC', `登录成功！OpenID: ${openId}`);
        
        // TODO：将凭证发送到应用服务器验证
      } else {
        hilog.error(0x0000, 'AGC', `登录失败: ${JSON.stringify(authResult)}`);
      }
    } catch (error) {
      const err: BusinessError = error as BusinessError;
      hilog.error(0x0000, 'AGC', `登录异常: code=${err.code}, message=${err.message}`);
    }
  }
}

// 在登录页面的Button组件调用登录方法
@Entry
@Component
struct LoginPage {
  build() {
    Column() {
      Button('华为帐号登录')
        .width('80%')
        .height(50)
        .margin(20)
        .onClick(() => {
          // 调用登录方法
          const abilityContext = ...; // 获取Ability上下文
          new EntryAbility().huaweiAccountLogin.call(abilityContext);
        })
    }
  }
}

##鸿蒙开发工具##Appgallery connect##商务#