HarmonyOS Connect生态产品 FAQ 汇总（持续更新）

1，企业实名认证，是否一定需法人手持身份证进行申请？

不需要。您可以选择对公银行打款认证的方式，完成实名认证。

2，企业实名认证，提示企业信息已注册帐号，如何找回？

如果忘记登录帐号，可以申请找回。找回帐号需提供以下材料，并将相关材料邮件至devConnect@huawei.com或者在线提单（https://developer.huawei.com/consumer/cn/support/feedback/#/）反馈，将由相关工作人员进行处理。

• 人工审核认证方式认证的帐号需要提供：“三证合一的营业执照”、“法定代表人身份证正反面扫描件”或者“法定代表人手持身份证正反面照片”。
• 对公银行打款认证方式认证的帐号需要提供：“三证合一的营业执照”、 “法定代表人身份证正反面扫描件”以及“认证时提供的企业对公帐号”。

3，主帐号邀请子帐号进入团队空间，被邀请者接收邮件邀请后，提示“服务暂不支持”

问题现象

被邀请者接收到加入项目的邮件邀请。登录Device Partner平台时，提示“服务暂不支持”。

可能原因

子帐号在加入团队空间时，未完成实名认证，登录管理中心。

解决措施

1）管理员重新发起邀请。

A,登录华为智能硬件合作伙伴平台，单击右上角的“管理中心”。

说明

建议使用谷歌浏览器访问，否则可能影响“团队帐号”功能的使用。

B,在左侧的导航栏中选择“帐号管理 > 团队帐号”，可以查看团队空间列表。

C,找到所需管理的团队空间，单击“成员管理”。

D,在成员列表底部，找到状态为“邀请待确认”的成员，单击“重新邀请”。

2）被邀请者接收邮件后，单击邮件中的 “此处”接受邀请。

3）在弹出的页面中，完成个人实名认证。

4）重新登录华为智能硬件合作伙伴平台。

4，创建品类时，部分品类为置灰状态，提示“开发中”

问题现象

在创建品类时，部分品类处于置灰的状态，无法选中，如下图。

​

可能原因

该品类未配置profile文件。

解决措施

请与华为对接人沟通，提供该品类的profile文件用于后台配置。

5，申请激活码时，提示“同步认证资源失败”

问题现象

申请产品激活码时，提示“同步认证资源失败”。

可能原因

该产品已申请过激活码后，修改品牌英文名、 产品型号或公司英文名简称，产品信息不一致导致冲突。

解决措施

评估此三个字段的修改是否必要。

• 如果有必要修改，请联系华为接口人，进一步反馈给平台技术支持处理。
• 如果无需修改，请将字段恢复为原有取值，再重新申请激活码。

6，手机碰一碰NFC标签，弹框提示“系统错误”，如何处理？

问题现象

手机碰一碰待连接设备，弹框提示“系统错误”，更换Wi-Fi后报错仍无法清除。

可能原因

手机时间与网络时间不一致。

设备发起请求时，会将手机时间与设备激活码等信息传到云端。云端会对手机时间与网络时间的一致性进行校验，以确保请求的合法性。如果两者的时间差大于一小时，则请求无效。

解决措施

将手机的时间设置为“自动设置”，使手机与当前网络上的时间同步。以华为手机为例：

1）进入手机“设置”。

2）选择“ 系统和更新 > 日期和时间”。

3）开启“自动设置”开关。

7，手机首次碰一碰NFC标签，拉起的是非配网FA页面

问题现象

手机首次碰一碰NFC标签，拉起的是非配网FA页面（比如控制FA页面）。

可能原因

原因一：服务意图配置的Ability名称不是配网FA页面的Ability名称。

原因二：原子化服务包中其他模块的Ability与配网FA的Ability重名，导致拉起的FA页面有误。

解决措施

1）确认服务意图配置的“服务名”是否为配网FA的Ability名称。

A,登录华为快服务智慧平台。

B,在服务列表中找到对应的原子化服务，单击“编辑”。

C,选择“配置 > FA信息”，确认配置方式中的“服务名”是否为配网FA的Ability名称。如果不正确，需要重新配置。

2）确认其他模块Ability名称是否与配网FA的Ability重名。

A,在DevEco Studio项目下，逐个排查其他模块中的“src/main/config.json”文件。

B,在json文件中，找到“module/mainAbility”配置项，检查是否与配网FA的Ability同名。

 C,找到并选中重名的Ability，单击右键，选择“Refactor > Rename”，重命名文件。

8，手机碰一碰已配网设备的NFC标签，无法拉起设备控制FA页面

问题现象

手机碰一碰已配网设备的NFC标签，拉起的是配网FA页面，而非设备控制FA页面。

可能原因

NFC标签中写入的14字段值与设备的SN不一致。

解决措施

检查NFC标签中的14字段与设备的SN号是否一致。如果不一致，需要重新写入。

9，手机碰一碰NFC标签，提示“未获取到应用信息”。

可能原因

原因一：服务意图配置的HarmonyOS标签的产品型号不是当前的ProductID。

原因二：NFC标签写入的码流中的ProductID有误。

原因三：未在Device Partner平台申请测试权限。

解决措施

1）确认服务意图配置的HarmonyOS标签的产品型号是否为当前的ProductID。

A,登录华为快服务智慧平台。

 B,在服务列表中找到对应的原子化服务，单击“编辑”。

 C,选择“配置 > HarmonyOS标签”，确认设备标签中的“产品型号”是否正确。如果不正确，需要重新配置。

2）确认NFC标签码流的ProductID字段是否正确。如果不正确，需要重新写入。

3）确认已在Device Partner平台申请测试权限。

  a. 登录华为智能硬件合作伙伴平台。

  b. 选择“帐号 > 基本资料”，单击页面右上角的“申请测试权限”。如果显示“尚未申请测试权限”，单击“立即申请测试权限”。

10，开发配网FA的华为帐号登录功能时，调用signIn接口，返回err，{"status":"FAILED","resultCode":"-1","data":"null"}

问题现象

开发配网FA的华为帐号登录功能时，调用signIn接口，返回err，{"status":"FAILED","resultCode":"-1","data":"null"}。Log日志错误信息如下：

app Log:  jsBridge log: json parse failed,interface is not exists or register.

可能原因

使用signIn接口时HmsBridge未全局注册。

解决措施

1）在“entry\build.gradle”文件中添加依赖包。

dependencies {
  implementation 'com.huawei.hms:jsb-ohos-adapter:5.3.0.303'
}

2）在MyApplication.java中注册HmsBridge。

public void onInitialize(){
  HmsBridge.getInstance().initBridge(this);
  super.onInitialize();
}

11，如何获取HiLinkSvc日志

1）打开手机的“文件管理”应用，进入“浏览”页面。

2）在“位置”列表中，选择“我的手机”。

3）进入“Android > data > com.huawei.hilink.framework > files > Log > com.huawei.hilink.framework”文件夹。此文件夹中的文件即为HinkSvc日志。

     如果无法自助解决问题，可以压缩日志文件夹，并发给华为技术支持人员进行定位。

12，在帐号登录FA界面单击“华为帐号快捷登录”，没有响应

问题现象

在帐号登录FA界面单击“华为帐号快捷登录”，没有响应。

可能原因

• 原因一：没有在AppGalley Connect网站添加应用指纹证书。
• 原因二：“config.json”文件中“metaData”下“customizeData”没有配置appid或者appid配置错误。

解决措施

1）在AppGalley Connect网站添加应用指纹证书。

2）在“config.json”文件中配置appid即为Client ID。

"metaData": {
"customizeData": [  
  {"name": "com.huawei.hms.client.appid",
   "value": "*********"
   }
]},

13，设备配网过程中，配网FA获取不到Wi-Fi列表

问题现象

设备配网过程中，配网FA获取不到Wi-Fi列表。

可能原因

• 原因一：配网模块中没有注册“NetConfigAbility”。
• 原因二：不止一个配网模块注册了“NetConfigAbility”。

解决措施

1）确认配网模块是否有注册“NetConfigAbility”。

    a.在配网模块下，找到该模块下的“MainAbility”，双击打开。

    b.检查该文件的onStart方法中是否含有NetConfigAbility.register()的代码。

2）确认是否存在多个注册了“NetConfigAbility”的配网模块。

   a.逐个排查各个配网模块“MainAbility”的onStart方法是否都注册了“NetConfigAbility”。

   b.只在一个配网模块中保留“NetConfigAbility”的注册，删除其他配网模块“NetConfigAbility”的注册代码。

14，设备配网过程中，使用SoftAP的方式未扫描到设备

问题现象

设备配网过程中，使用SoftAP的方式未扫描到设备。

​

可能原因

• 原因一：Wi-Fi设备未开启。
• 原因二：Wi-Fi设备已开启，getWifiList接口读取的是Wi-Fi缓存信息。
• 原因三：NFC标签码流的MAC地址与Wi-Fi设备的MAC地址不一致。

解决措施

1）确认Wi-Fi设备已开启。

2）间隔一段时间（约2min）后，重新扫描设备。如果多次扫描仍提示配网失败，重试重置设备。

3）确认NFC标签码流的MAC地址是否与Wi-Fi设备的MAC地址一致。如果不一致，则需要重新烧录正确的NFC码流信息。

15，使用SoftAP方式完成设备配网后，拉起控制FA失败

问题现象

使用SoftAP的方式完成设备配网后，拉起控制FA失败，手机弹框提示“查询失败”。

可能原因

手机在SoftAP配网完成后会从设备的热点切回原来连接的Wi-Fi，此时有可能网络还未恢复正常，导致查询设备控制FA失败。

解决措施

通过代码实现如下逻辑：配网成功后，延迟几秒（例如3s）再去启动控制页FA。

16，碰一碰拉起配网FA，在SoftAP配网进度达30%时失败，显示“当前网络不可用”

问题现象

碰一碰拉起配网FA，在进行SoftAP配网时配网进度在30%失败，提示“当前网络不可用”。

可能原因

• 原因一：模组侧因长时间不启用进入待机状态，关闭了配网所需的设备AP。
• 原因二：NFC标签码流中0406字段后6字节写入的数据与设备开启的AP MAC地址不一致。

解决措施

1）确保设备AP无线网络名称正确。

   a.登录华为智能硬件合作伙伴平台，单击右上角的“管理中心”。

  b.单击对应的产品，进入“集成开发”页面。在配网设置中查看并记录“无线网络名称”(SSID)的取值。

  c.在手机中打开“设置”，选择“WLAN > 可用WLAN”，确保该列表中存在与记录的SSID相同的设备AP。

•        若无相同SSID的设备AP，请尝试重启设备。
•         若产品ID一致但SSID名称不一致，请重新烧录模组使SSID与记录的一致。

2）修改标签码流MAC字段并重新烧录NFC。

17. 设备处于开机状态且手机网络正常，但智慧生活APP上设备卡片显示离线状态

问题现象

设备处于开机状态且手机网络正常，但智慧生活APP上设备卡片显示离线状态，且串口工具不停重复打印设备侧日志“+NOTICE:SCANFINISH/+NOTICE:DISCONNECTED”。

可能原因

设备已连接的热点的SSID或密码发生变更。

解决措施

• 方式一：将热点SSID和密码改回，模组即可重新连接热点，恢复正常。
• 方式二：将模组重置，重新给模组配网。

18，无法触发自动安装FA的功能，导致配网FA拉起控制FA失败

问题现象

手机上没有安装控制FA，配网FA拉起控制FA失败；如果手机上已经安装控制FA，则可以正常拉起。

可能原因

配网FA使用StartAbility拉起控制FA，需要传入flag，flag未包含FLAG_INSTALL_ON_DEMAND，导致无法触发自动安装FA的功能。

解决措施

将flag设置为“276826112”，该取值包含了FLAG_INSTALL_ON_DEMAND和FLAG_ABILITY_NEW_MISSION等flag。关于flag的取值和说明可以参看Ability框架的意图常量。

19，HarmonyOS Connect设备固件需要支持通过FA进行OTA升级，在FA侧OTA升级入口呈现有什么要求？

OTA升级功能需要满足如下条件：

   1）在FA界面上可以查看当前设备固件版本信息。

   2）在FA界面上操作，可以触发设备固件OTA升级到新的设备固件版本。

   3）在固件版本升级后，通过FA界面可以查看固件版本信息变更为新版本。

具体的OTA升级入口由厂商自行实现，常见的实现方式举例如下：

• 可以提供一个OTA查询按钮。单击查询按钮，检查是否存在新版本设备固件，并提示用户升级。
• 可以主动在FA界面上显示出有新版本设备固件，让用户选择是否升级。

20，使用开放网络对设备进行配网，结果配网失败

问题现象

在给设备配网时，选择开放网络进行配网，模组侧打印 “ConnectTo conn failed -9”，导致配网失败。

可能原因

设备使用了FastConnect进行连接，而FastConnect是不支持开放网络的。

解决措施

在ParseNetCfgDate函数里找到FastConnect调用的地方，加上分支判断，如果是开放网络，调用NormalConnect进行连接，否则使用FastConnect进行连接。

21，碰一碰拉起配网FA，无法进行NAN配网

问题现象

碰一碰拉起配网FA，无法进行NAN配网，FA日志中打印碰一碰Intent参数nanSessionId字段的值为“NAN_DEVICE_NOT_FOUND”。

可能原因

• 用于配网的模组不支持NAN配网。
• 手机与模组之间距离大于30cm。
• 上一次碰一碰拉起配网FA进行NAN配网未完成，模组的NAN通道将锁定一段时间。

解决措施

1）咨询产品对应模组厂商，确认模组是否支持NAN配网。

2）将手机靠近至模组30cm半径以内后重新碰一碰配网。

3）等待模组日志打印以下信息时，即可进行NAN配网(x代表任意数字)。

Send: msgType[x] msgId[x] msgLen[x]

若模组日志打印显示以下信息，则表示当前模组只能进行SoftAP配网，请重启模组或重新烧录模组。

wait STA join AP

22，模组在STA模式下连接路由器热点，路由器断电重启或模组离开热点范围再返回后无法重连热点

问题现象

1）模组短距测试中，执行如下命令设置模组打开STA模式。

AT+STARTSTA

2）执行如下命令，扫描模组周围热点。

AT+SCAN

3）执行如下命令，查看扫描结果。

AT+SCANRESULT

4）参考执行如下命令，连接热点。命令中的四个值分别代表SSID、MAC、热点类型以及密码，请根据实际情况修改。

AT+CONN="hisilicon",1a:01:f1:c9:7c:92,3,"123456789"

6）执行如下命令，打开DHCP。

AT+DHCP=wlan0,1

路由器断电重启或者模组离开热点范围再返回，此时发现模组无法重新连接该热点。

可能原因

模组未配置重连策略。

解决措施

AT+RECONN=1,10,3600,5

参考如下命令执行重连策略，命令中的参数需要根据实际情况修改，具体取值参见芯片手册。

23，设备配网失败且设备侧日志显示“Parse symbol authentication response message failed”

问题现象

设备配网的过程中，串口工具打印的设备侧日志显示“Parse symbol authentication response message failed”，配网流程结束后，智慧生活App显示设备配网失败。

可能原因

• 原因一：hal_sys_param.c文件中的产品信息未配置正确。
• 原因二：设备激活码与产品信息不匹配。
• 原因三：Device Partner平台管理中心上添加的调测设备SN与HalGetSearial接口返回的value值不一致。

解决措施

1）检查hal_sys_param.c文件中企业英文名、产品型号、品牌英文名信息是否配置正确，确保和Device Partner平台管理中心上的产品信息保持一致。

2）在Device Partner平台管理中心上重新申请设备激活码，并写入设备。

3）检查hal_sys_param.c文件中HalGetSearial接口的实现，可通过打印value方式查看其返回值是否和Device Partner平台管理中心上配置的调测设备   SN是否一致（注意大小写也需要保持一致）。

24，如何抓取HarmonyOS手机蓝牙HCI日志

1）确认手机已进入开发者模式并开启“USB调试”功能。

    a. 在手机中打开“设置 ”。

    b.选择“关于手机”，查找版本号。

    c.快速点击“版本号”多次，直到提示开发者模式已打开，返回上一层。

    d.选择“系统和更新 > 开发人员选项”，并开启“USB调试”。

2）在电脑中运行cmd命令。

3）在命令行中输入如下命令，导出的文件即为手机蓝牙HCI日志。

hdc file recv /data/log/bt ./

如果无法自助解决问题，可以压缩日志文件夹，并发给华为技术支持人员进行定位。

25，碰一碰NFC标签无法拉起FA，NFC服务提示“发现NFC标签，点击启动应用”

问题现象

手机碰一碰待连接设备，NFC服务弹出提示“发现NFC标签，点击启动应用”，没有正常拉起原子化服务。

​

可能原因

NFC标签码流录入错误，导致手机系统无法正确解析NFC码流。

解决措施

1）在Device Partner平台上申请NFC标签码流，并根据实际设备信息生成可用的标签码流。

2）将码流重新写入NFC标签，并重试碰一碰 

26，设备配网过程中，设备侧日志已显示“get wifi ssid pwd done”，但热点无法连接

问题现象

设备配网的过程中，设备侧日志已显示“get wifi ssid pwd done”，但之后串口工具循环打印设备侧日志“+NOTICE:SCANFINISH/+NOTICE:DISCONNECTED”，热点无法连接，最终设备配网失败。

可能原因

• 原因一：在智慧生活App扫描配网输入热点信息界面时，输入了错误的SSID或密码。
• 原因二：勾选了记住密码，但热点密码已发生了改变，再次配网时传入了旧密码导致。

解决措施

1. 将设备重置，并重新进入待配网状态。
2. 重新给设备配网，在热点信息界面输入正确的SSID和密码。

27，调用帐号SDK接口getSignInIntent()时返回错误码，如何处理

调用帐号SDK接口getSignInIntent()时，返回错误码（例如6003、907135702、907135000），请参考HMS Core SDK框架错误码。

28，Hi3861模组在Wi-Fi-STA模式下，如何使用AT命令连接SSID名称为“！@#￥%&*\”的热点

执行如下命令连接热点，“\”需要再加一个“\”进行转义。

AT+CONN="！@#￥%&*\\"

29，华为帐号授权页面不显示厂商logo

问题现象

华为帐号授权页面厂商logo显示空白。

可能原因

华为开发者联盟平台的应用信息中没有上传应用图标。

解决措施

1. 登录华为开发者联盟平台。
2. 单击“我的项目”，单击应用所在项目。
3. 在上侧Tab栏中选择HarmonyOS应用。
4. 单击上侧Tab栏选择“我的应用”，在“应用信息”按照要求添加应用图标。
5. 完善应用信息后，提交审核即可。

30，在原子化服务开发中，如何实现MAC地址和SN号的获取？

1. 打开配网入口模块的Ability类。
2. 在“onStart”方法中加入以下两行代码，即可获取MAC地址和SN号。

String bleMac = intent.getStringParam("bleMac"); // 此处以蓝牙MAC为例
String sn = intent.getStringParam("sn");