HarmonyOS 鸿蒙Next的“实况窗”怎么开发？能用在外卖订单追踪上吗？

期待HarmonyOS能在未来带来更多创新的技术和理念。

针对 ** 鸿蒙 6（API Level 10）** 的外卖订单实况窗（实时卡片）开发，需结合鸿蒙 6 对原子化服务 & 实时卡片的优化特性（更灵活的更新策略、更稳定的后台能力、更好的多设备适配），以下是适配鸿蒙 6 的专属开发指南：

一、鸿蒙 6 下 “实况窗” 的核心变化

鸿蒙 6 中 “实况窗” 统一称为 「实时动态卡片」，相比旧版本有 2 个关键优化：

1. 支持更短的更新间隔（最小 30 秒 / 次，适配外卖骑手位置的高频变化）；
2. 支持后台保活更新（原子化服务后台权限在鸿蒙 6 中更易申请，避免更新中断）；
3. 支持折叠屏 / 平板的自适应尺寸（卡片可自动适配不同设备的桌面布局）。

二、鸿蒙 6 专属开发步骤（外卖订单场景）

步骤 1：创建鸿蒙 6 原子化服务项目

• 确保 DevEco Studio 版本≥4.1（支持鸿蒙 6 API 10）；
• 新建项目→选择「原子化服务」→「Stage 模型 + ArkTS」→最小 SDK 版本选择 “6.0.0（API 10）”。

步骤 2：鸿蒙 6 下的卡片配置（module.json5）

鸿蒙 6 对formConfig新增了动态尺寸、后台更新策略等配置，需按以下配置：

{
  "module": {
    "abilities": [
      {
        "name": ".TakeawayLiveCardAbility",
        "type": "form",
        "visible": true,
        "extensionAbilityType": "form",
        "formConfig": {
          "isDefault": true,
          "formType": "Realtime", // 鸿蒙6明确“实时卡片”类型
          "scheduledUpdateTime": "00:00",
          "updateDuration": 30, // 鸿蒙6支持最小30秒/次更新（适配骑手位置频率）
          "defaultDimension": "2*2", // 默认尺寸
          "supportDimensions": ["2*2", "4*2", "2*4"], // 鸿蒙6支持多尺寸自适应
          "backgroundUpdateEnable": true, // 鸿蒙6新增：允许后台更新（关键）
          "formLink": "/pages/OrderDetail" // 鸿蒙6新增：卡片点击跳转的App页面
        }
      }
    ],
    "requestPermissions": [
      {
        "name": "ohos.permission.LOCATION",
        "reason": "获取骑手位置",
        "usedScene": { "abilities": [".TakeawayLiveCardAbility"], "when": "always" }
      },
      {
        "name": "ohos.permission.KEEP_BACKGROUND_RUNNING",
        "reason": "后台更新订单数据",
        "usedScene": { "abilities": [".TakeawayLiveCardAbility"], "when": "always" }
      }
    ]
  }
}

步骤 3：鸿蒙 6 适配的实况窗 UI（支持动态尺寸）

鸿蒙 6 的 ArkTS 支持@FormDimension装饰器，可根据卡片尺寸动态调整 UI（比如大尺寸显示地图缩略图，小尺寸显示文字）：

// TakeawayLiveCard.ets（实时卡片UI）
@Entry
@Component
struct TakeawayLiveCard {
  @State riderLocation: string = "骑手已到XX路";
  @State deliveryTime: string = "预计5分钟送达";
  @FormDimension currentDimension: string = "2*2"; // 鸿蒙6获取当前卡片尺寸

  build() {
    Column() {
      // 大尺寸卡片（4*2）显示地图缩略图
      if (this.currentDimension === "4*2") {
        Image('https://your-map-api.com/rider?lat=xxx&lng=xxx') // 实时地图缩略图
          .width('100%')
          .height(80);
      }
      // 通用信息（骑手位置+预计时间）
      Row({ space: 8 }) {
        Image($r('app.media.rider_icon'))
          .width(24)
          .height(24);
        Text(this.riderLocation)
          .fontSize(this.currentDimension === "2*2" ? 14 : 16);
      }
      Row({ space: 8 }) {
        Image($r('app.media.clock_icon'))
          .width(24)
          .height(24);
        Text(this.deliveryTime)
          .fontSize(14)
          .fontColor('#FF6B00');
      }
    }
    .width('100%')
    .height('100%')
    .padding(12)
    .justifyContent(FlexAlign.Center);
  }
}

步骤 4：鸿蒙 6 的实时数据更新（更高效）

鸿蒙 6 优化了formProvider的更新接口，支持批量更新 + 低延迟推送，结合外卖场景的实现：

1. App 侧推送骑手数据：

// 订单页面（App侧）
import formProvider from '@ohos.app.form.formProvider';

// 骑手位置更新时，推送数据到实况窗
async function pushRiderData(formId: string, location: string, time: string) {
  const formData = { riderLocation: location, deliveryTime: time };
  // 鸿蒙6新增：支持“高优先级更新”
  await formProvider.updateForm(formId, formData, { priority: 1 }); 
}

1. 实况窗接收并刷新：

// TakeawayLiveCardAbility.ets（FormExtensionAbility）
export default class TakeawayLiveCardAbility extends FormExtensionAbility {
  // 鸿蒙6的onFormUpdate支持更详细的更新信息
  onFormUpdate(formId: string, message: formProvider.FormUpdateMessage): void {
    const newData = message.param;
    // 鸿蒙6优化：更新UI时自动触发轻量渲染（不重绘整个卡片）
    this.updateFormData(formId, newData);
  }
}

步骤 5：鸿蒙 6 的权限动态申请（必须）

鸿蒙 6 对权限管控更严格，需在原子化服务启动时动态申请权限：

// FormExtensionAbility中申请权限
onCreate(want: Want): void {
  // 动态申请位置+后台保活权限
  abilityAccessCtrl.createAtManager().requestPermissionsFromUser(
    this.context,
    ["ohos.permission.LOCATION", "ohos.permission.KEEP_BACKGROUND_RUNNING"]
  );
}

三、鸿蒙 6 下的核心优势（外卖场景）

1. 更新更及时：30 秒 / 次的更新间隔，比旧版本（1 分钟）更适配骑手位置的实时变化；
2. 后台更稳定：KEEP_BACKGROUND_RUNNING权限在鸿蒙 6 中对原子化服务更宽松，避免订单更新中断；
3. 多设备适配：折叠屏 / 平板上卡片自动切换尺寸（小尺寸显文字、大尺寸显地图），用户体验更好。

四、用户添加实况窗到桌面（鸿蒙 6 操作）

鸿蒙 6 简化了卡片添加流程：

1. 安装原子化服务后，长按 App 图标→选择「添加实时卡片」；
2. 选择尺寸（22/42），直接固定到桌面，实时显示骑手位置 & 送达时间。

总结：鸿蒙 6 的实况窗（实时卡片）完全适配外卖订单追踪场景，核心是利用其 “更短更新间隔 + 稳定后台” 的特性，结合动态权限 + 多尺寸 UI，实现桌面实时展示的需求。