使用模拟器调试
=======

使用模拟器调试时，需在AGC云侧注册调试凭据，以保护应用/元服务对Cloud Foundation Kit的访问。在模拟器中启动应用/元服务时，开发者触发一次云函数、云数据库或云存储业务接口，该模拟器下会生成调试凭据并输出到日志；将生成的调试凭据注册到AGC云侧，即可在模拟器中调试应用/元服务。

具体可按如下步骤操作：

1.  获取调试凭据。
    
    1.  创建并启动模拟器，具体请参见[管理模拟器](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-management)。
        
    2.  在模拟器中启动应用，并触发任意一次云函数、云数据库或云存储业务接口（建议使用云函数接口）。此时，由于未注册调试凭据，接口调用会失败，请忽略，继续执行下一步。
        
    3.  通过设置“No filters”模式、过滤“clouddevelopproxy.debugToken”关键字，查找日志中打印的调试凭据，并复制该调试凭据。
        
        格式示例：\[clouddevelopproxy.debugToken=xxx\]，其中“xxx”为调试凭据。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a4/v3/-SWYvHHSRRmoRbZawz_shw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073605Z&HW-CC-Expire=86400&HW-CC-Sign=B578CE477105446B92C8FFBD7DCB9F565442318C9C12110983B41C6CF894A10D)
        
        如日志中查找不到调试凭据，请排查应用是否使用了错误的签名方式。当前Cloud Foundation Kit支持[关联注册应用进行自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section20943184413328)和[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)两种方式，请修改后再重试。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/90/v3/AwHSHVFRTS6nICayBrRMFg/zh-cn_image_0000002594829096.png?HW-CC-KV=V1&HW-CC-Date=20260612T073605Z&HW-CC-Expire=86400&HW-CC-Sign=4EA04F5C83EB909CAABB8034E741C74E4B98A367708E661AAE20469DCB864829)
        
2.  将获取的调试凭据注册到AGC云侧，具体可参见[注册模拟器调试凭据](https://developer.huawei.com/consumer/cn/doc/app/agc-help-add-credential-0000002415343501)。
    
3.  调试凭据注册成功后，您即可使用模拟器调试应用/元服务。关于模拟器使用指导，请参见[使用模拟器运行应用](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-run-emulator)。
    
    如调用接口时返回的错误信息提示401签名校验失败或者403鉴权失败，可能原因如下：
    
    *   调试凭据未注册。请先[注册模拟器调试凭据](https://developer.huawei.com/consumer/cn/doc/app/agc-help-add-credential-0000002415343501)。
        
    *   注册调试凭据时绑定了错误的应用/元服务。请先删除该调试凭据，重新绑定正确的应用/元服务，等待30分钟后再进行调试。