FamilyBook_harmonyos/entry/src/main/module.json5

{
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "phone",
      "tablet"
    ],
    "requestPermissions": [
      {
        "name": "ohos.permission.INTERNET"
      },
      {
        "name": "ohos.permission.GET_NETWORK_INFO"
      },
      {
        // 🔴 质感握姿（左手/右手握持）—— 用户 2026-10-16 第 4 条。
        //    `multimodalAwareness.motion` 的 `holdingHandChanged` 要求此权限。
        //    ⚠️ 它是 `system_grant` + `availableLevel: normal` + `provisionEnable: false`
        //      （在 SDK 的权限定义里核过）⇒ **安装即获得，不会弹授权框**。
        //    ⚠️ API 20 起才有；低版本设备会抛 801（能力不支持）——
        //      代码里已 try/catch 兜住，拿不到就退回默认方向。
        "name": "ohos.permission.DETECT_GESTURE"
      }
    ],
    "deliveryWithInstall": true,
    "installationFree": false,
    "pages": "$profile:main_pages",
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "description": "$string:EntryAbility_desc",
        // 🔴 v45 修：原为 `$media:layered_image`（分层图标），导致桌面图标
        //    外面有一圈米色底、且图案显得小。原因：
        //      · `background.png` 是**纯米色满幅图**（512²）⇒ 那圈底色；
        //      · `foreground.png` 的图案**只占 44%**，系统还要留安全区
        //        ⇒ 图案被缩得更小。
        //    另一个真 bug：`app.json5` 的分层图在 **AppScope** 下找，
        //    但 `background/foreground.png` **只在 entry 里**，AppScope 里没有
        //    ⇒ 引用落空。
        //    ⇒ 直接改用与应用内左上角**同一个** `fb_logo`（图案几乎铺满）。
        "icon": "$media:fb_logo",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:startIcon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "orientation": "auto_rotation_restricted",
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "ohos.want.action.home"
            ]
          }
        ]
      }
    ],
    "extensionAbilities": [
      {
        "name": "EntryBackupAbility",
        "srcEntry": "./ets/entrybackupability/EntryBackupAbility.ets",
        "type": "backup",
        "exported": false,
        "metadata": [
          {
            "name": "ohos.extension.backup",
            "resource": "$profile:backup_config"
          }
        ]
      },
      // 🔴 v66（用户 2026-10-20「做几个和 syncCalendar 差不多的卡片」）：
      //    桌面服务卡片。三种尺寸（2×2 / 2×4 / 4×4）都登记在 `form_config.json`，
      //    这里只声明**提供方**（FormExtensionAbility）。
      //    ⚠️ `type` 必须是 `form`，`metadata` 的名字必须是 `ohos.extension.form`，
      //       少一个桌面就把这个应用当成"没有卡片"。
      {
        "name": "FbFormAbility",
        "srcEntry": "./ets/entryformability/FbFormAbility.ets",
        "description": "$string:form_ability_desc",
        "type": "form",
        "exported": true,
        "metadata": [
          {
            "name": "ohos.extension.form",
            "resource": "$profile:form_config"
          }
        ]
      }
    ]
  }
}