---

上周帮朋友提交一款搭载沉浸光感特性的鸿蒙5.0应用上架，结果被连续打回8次。从一开始的"不耐烦"到最后的"摸清套路"，整整折腾了两周。每一条拒审理由都让我重新审视了一遍鸿蒙应用的开发规范。今天把这些踩过的坑和整理出的避坑清单全部公开，建议先收藏再慢慢看，等你自己上架的时候直接对照检查就行。

一、最容易被忽视的6个拒审原因

1. 权限声明与实际功能不匹配

这是我第一个被拒的理由。应用里接入了位置权限，但审核员在试用过程中没触发到需要位置的场景，直接判定为"过度索取权限"。

正确做法： 权限要按需声明，用户触发功能时再弹窗申请。如果是鸿蒙5.0新增的权限（如沉浸光感需要的设备姿态权限），要在配置文件里标注清楚用途：

"requestPermissions": [
  {
    "name": "ohos.permission.LOCATION",
    "reason": "$string:reason_location",
    "usedScene": {
      "abilities": ["EntryAbility"],
      "when": "inuse"
    }
  }
]

关键是 when 字段必须明确写 inuse，表示仅在使用中申请，不要用 always。

2. 图标和启动图未适配深色模式

鸿蒙5.0全面支持深色模式，审核时会自动切换检测。我用的图标是设计师给的白底版本，深色背景下看起来特别突兀，直接被打回。

正确做法： 每个图标需要准备两套资源，在不同目录下区分。启动图要同时适配手机、平板、折叠屏三种分辨率：

resources/
  base/media/         浅色模式图标
  dark/media/         深色模式图标（背景透明或深灰底）
  phone/media/        手机专用启动图
  tablet/media/       平板专用启动图
  foldable/media/     折叠屏专用启动图

3. 应用首次启动未展示隐私协议

这个坑我完全没想到。鸿蒙应用要求首次启动必须弹出隐私协议，用户同意后才能继续使用。我的应用是直接进入主界面，被审核员判定为"违规收集用户信息"。

正确做法： 在 EntryAbility 的 onCreate 方法中检测用户是否已同意隐私协议，未同意则弹出协议弹窗：

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  const privacyManager = new PrivacyManager();
  const isAgreed = privacyManager.getPrivacyStatus();

  if (!isAgreed) {
    this.showPrivacyDialog();
  }
}

4. 沉浸光感特性违反系统视觉规范

这是最头疼的一条。鸿蒙5.0的沉浸光感（Immersive Light Sensing）会根据环境光调整屏幕亮度和色彩温度，但我设置的参数范围超出了系统限制。

正确做法： 使用沉浸光感API时必须遵守系统约束，亮度参数控制在0-255范围内，色温参数在2000K-8000K之间：

import { immersiveLightSensing } from '@kit.SensorServiceKit';

const sensor = immersiveLightSensing.createSensor();
sensor.on('change', (data: immersiveLightSensing.LightData) => {
  const brightness = Math.min(data.brightness, 200);
  const colorTemp = Math.max(Math.min(data.colorTemperature, 6500), 2500);
  this.updateDisplay(brightness, colorTemp);
});

5. 应用内存在未关闭的调试日志

开发过程中留下的 console.log 和 hilog 语句，在鸿蒙上架审核中会被检测出来。

正确做法： 打包前用 Lint 扫描，或在配置文件中自动移除：

"buildOption": {
  "removeLog": true,
  "strictMode": { "caseSensitive": true }
}

6. 应用版本号格式不规范

鸿蒙要求版本号格式必须是 主版本.次版本.修订版本，不能带后缀。

"app": {
  "versionCode": 100000,
  "versionName": "1.0.0"
}

二、上架前自检Checklist（建议收藏）

检查项	要求	状态
权限声明	按需声明，when字段设为inuse	☐
图标适配	深色/浅色模式各一套	☐
启动图	适配手机/平板/折叠屏	☐
隐私协议	首次启动弹窗，内容完整	☐
调试日志	全部移除或关闭	☐
版本号	纯数字，格式正确	☐
沉浸光感参数	亮度0-200，色温2500K-6500K	☐
网络请求	明文请求已加密，无http开头地址	☐
敏感权限	定位/通讯录等需单独说明用途	☐
应用截图	覆盖主要功能界面，无黑屏/乱码	☐

三、3个加速审核的实用技巧

1. 功能描述写详细：在应用商店描述中把所有核心功能点列出来，包括新特性的触发条件和效果。

2. 提前标注新能力：如果应用用了鸿蒙5.0新特性，提交时选择"包含新特性"，审核员会重点关注新特性部分，减少对老功能的挑剔。

3. 被拒后针对性修改：每次被打回都会收到具体理由，逐条修复比盲目修改效率高。

---