引言

鸿蒙元服务（原原子化服务）作为“一次开发、多端部署、免安装使用”的新型应用形态，凭借“轻量便捷”“场景化触达”的优势，成为鸿蒙生态的核心增长点。很多开发者想入局元服务开发，但受限于对“服务卡片开发”“免安装机制”“分发推广”等关键环节的不熟悉，难以落地。本文从元服务核心特性入手，拆解服务卡片开发、免安装运行、分发推广全流程，结合“本地生活服务元服务”实战案例，帮助开发者快速掌握元服务从开发到上线的完整链路。

一、鸿蒙元服务核心特性与技术架构

1.1 核心特性：轻量、便捷、场景化

元服务区别于传统APP的三大核心特性：

• 免安装运行：用户无需下载安装，通过服务卡片、扫码等方式直接启动，安装包体积通常＜10MB；
• 服务卡片化：支持在手机桌面、负一屏展示服务卡片，直接展示核心信息（如天气、外卖订单），点击卡片可启动完整服务；
• 场景化分发：可通过“碰一碰”“扫码”“搜索推荐”等多种方式触达用户，适配多设备场景（手机、平板、车机）。

1.2 技术架构：“卡片+服务”双核心

元服务采用“服务卡片+基础服务”的双层架构，各层职责明确：

1. 服务卡片层：用户交互入口，分为“静态卡片”和“动态卡片”。静态卡片仅展示固定信息，动态卡片支持实时更新数据（如外卖进度），通过“卡片提供方”与“卡片使用方”的通信机制实现数据同步；
2. 基础服务层：核心业务逻辑载体，采用“Ability”形式实现，支持免安装启动，可调用鸿蒙系统API实现网络请求、数据存储等功能；
3. 通信机制：卡片层与服务层通过“Want”机制通信，卡片点击后通过Want启动基础服务，服务层数据更新后通过“卡片刷新接口”同步到卡片。

1.3 开发前提：环境与账号准备

1. 开发环境：DevEco Studio 4.0及以上版本，配置HarmonyOS SDK 10及以上，安装“元服务开发插件”（DevEco Studio中通过“Tools > Plugin Market”搜索安装）；2. 账号准备：注册华为开发者联盟账号并完成实名认证，在“元服务平台”（https://developer.huawei.com/consumer/cn/atomic-service/）创建元服务项目，获取应用ID和证书。

二、实战案例：本地生活服务元服务开发

2.1 需求定义

开发一款“本地美食推荐”元服务，核心需求：1. 桌面服务卡片展示“今日推荐美食”和“距离最近的3家餐厅”；2. 卡片支持下拉刷新更新推荐内容；3. 点击卡片进入免安装服务，展示餐厅详情、评价和导航功能；4. 支持“扫码启动”和“桌面添加卡片”两种分发方式。

2.2 技术选型

• 服务卡片：采用“动态卡片”，通过定时刷新和下拉刷新更新数据；
• 基础服务：采用“Page Ability”实现，支持免安装启动；
• 数据同步：卡片与服务通过Want通信，服务数据更新后调用卡片刷新API；
• 定位服务：调用鸿蒙定位API获取用户位置，实现附近餐厅推荐。

2.3 核心代码实现

步骤1：服务卡片配置（module.json5）

元服务的卡片配置需在模块配置文件中声明，指定卡片尺寸、样式、提供方等信息：

{
  "module": {
    "name": "foodService",
    "type": "atomic_service", // 类型：元服务
    "mainAbility": "com.example.foodservice.MainAbility",
    "deviceTypes": ["phone", "tablet"],
    // 服务卡片配置
    "cards": [
      {
        "name": "FoodRecommendCard", // 卡片名称
        "type": "dynamic", // 动态卡片
        "dimension": [2, 4], // 卡片尺寸：2x2、4x2（宽x高，单位：网格）
        "provider": "com.example.foodservice.card.FoodCardProvider", // 卡片提供方
        "updateCycle": 3600, // 定时刷新周期（秒），动态卡片必填
        "defaultLayout": "$layout:card_food_recommend", // 默认布局
        "previewLayout": "$layout:card_food_preview" // 预览布局
      }
    ]
  }
}

步骤2：服务卡片布局设计（card_food_recommend.ets）

// 服务卡片布局：2x2尺寸，展示推荐美食和附近餐厅
@Card
struct FoodRecommendCard {
  // 卡片数据（从卡片提供方获取）
  private data: {
    todayRecommend: string;
    nearbyRestaurants: Array<{ name: string; distance: string }>;
  } = {
    todayRecommend: "香辣小龙虾",
    nearbyRestaurants: []
  };

  build() {
    Column({ space: 10, padding: 15 }) {
      // 标题栏
      Row({ justifyContent: FlexAlign.SpaceBetween }) {
        Text("美食推荐")
          .fontSize(18)
          .fontWeight(FontWeight.Bold);
        Image($r("app.media.refresh"))
          .width(20)
          .height(20)
          .onClick(() => {
            // 下拉刷新触发：通过卡片提供方刷新数据
            postCardAction(this, {
              action: "refresh",
              params: {}
            });
          });
      }

      // 今日推荐
      Text(`今日推荐：${this.data.todayRecommend}`)
        .fontSize(16)
        .maxLines(1)
        .textOverflow(TextOverflow.Ellipsis);

      // 附近餐厅列表
      Column({ space: 5 }) {
        ForEach(this.data.nearbyRestaurants.slice(0, 2), (item) => {
          Text(`${item.name}（${item.distance}）`)
            .fontSize(14)
            .color("#666666");
        });
      }
      .margin({ top: 5 })

      // 卡片点击区域（跳转至基础服务）
      .onClick(() => {
        postCardAction(this, {
          action: "router",
          params: {
            uri: "ability://com.example.foodservice.MainAbility", // 目标服务Ability
            params: JSON.stringify({ from: "card" })
          }
        });
      })
    }
    .width("100%")
    .height("100%")
    .backgroundColor("#ffffff")
    .borderRadius(12)
  }
}

步骤3：卡片提供方实现（数据刷新逻辑）

import { CardProvider, CardData } from '@ohos.application.card';
import { Geolocation } from '@ohos.location';
import { FoodService } from '../service/FoodService';

// 卡片提供方：负责卡片数据更新和刷新
export class FoodCardProvider extends CardProvider {
  // 卡片初始化时调用
  onInitialize(cardId: string, data: CardData): void {
    this.refreshCardData(cardId);
  }

  // 卡片刷新时调用（定时刷新/手动刷新触发）
  async onRefresh(cardId: string, data: CardData): Promise<CardData> {
    return await this.refreshCardData(cardId);
  }

  // 刷新卡片数据（核心逻辑）
  private async refreshCardData(cardId: string): Promise<CardData> {
    try {
      // 1. 获取用户位置（简化：实际需申请定位权限）
      const location = await Geolocation.getCurrentLocation();
      // 2. 调用服务获取美食推荐和附近餐厅
      const todayRecommend = await FoodService.getTodayRecommend();
      const nearbyRestaurants = await FoodService.getNearbyRestaurants(
        location.latitude,
        location.longitude
      );
      // 3. 构造卡片数据
      const cardData: CardData = {
        data: JSON.stringify({ todayRecommend, nearbyRestaurants }),
        status: 0
      };
      // 4. 更新卡片数据
      this.updateCardData(cardId, cardData);
      return cardData;
    } catch (err) {
      console.error("刷新卡片数据失败：", err);
      return { data: "", status: -1 };
    }
  }
}

步骤4：基础服务实现（免安装启动）

基础服务采用Page Ability实现，支持免安装启动，接收卡片传递的参数并展示完整功能：

import router from '@ohos.router';
import { FoodService } from '../service/FoodService';

@Entry
@Component
struct FoodMainPage {
  @State todayRecommend: string = "";
  @State nearbyRestaurants: Array<{
    name: string;
    distance: string;
    rating: number;
    image: Resource;
  }> = [];
  @State isLoading: boolean = true;

  async aboutToAppear() {
    // 获取卡片传递的参数
    const params = router.getParams();
    console.log("启动来源：", params?.from);
    // 加载数据
    await this.loadData();
  }

  // 加载美食数据
  private async loadData() {
    this.isLoading = true;
    try {
      const location = await Geolocation.getCurrentLocation();
      this.todayRecommend = await FoodService.getTodayRecommend();
      this.nearbyRestaurants = await FoodService.getNearbyRestaurantsDetail(
        location.latitude,
        location.longitude
      );
    } catch (err) {
      promptAction.showToast({ message: "数据加载失败" });
    } finally {
      this.isLoading = false;
    }
  }

  build() {
    Column({ space: 15 }) {
      // 标题栏
      Text("本地美食推荐")
        .fontSize(28)
        .fontWeight(FontWeight.Bold)
        .padding({ left: 20, top: 30 })
        .alignSelf(ItemAlign.Start);

      // 今日推荐
      Column({ space: 10, padding: 20 })
        .backgroundColor("#fff3e0")
        .borderRadius(12)
        .width("90%") {
        Text("今日必吃")
          .fontSize(16)
          .color("#e65100");
        Text(this.todayRecommend)
          .fontSize(22)
          .fontWeight(FontWeight.Bold);
        Button("查看详情")
          .width(120)
          .height(40)
          .backgroundColor("#e65100")
          .fontColor("#ffffff")
          .borderRadius(20);
      }

      // 附近餐厅列表
      Text("附近餐厅")
        .fontSize(20)
        .fontWeight(Medium)
        .padding({ left: 20 })
        .alignSelf(ItemAlign.Start);

      if (this.isLoading) {
        Progress()
          .width(100)
          .height(100)
          .margin({ top: 50 });
      } else {
        List({ space: 15 }) {
          ForEach(this.nearbyRestaurants, (item) => {
            ListItem() {
              Row({ space: 15, alignItems: ItemAlign.Start })
                .padding(20)
                .backgroundColor("#ffffff")
                .borderRadius(12)
                .width("100%") {
                Image(item.image)
                  .width(100)
                  .height(100)
                  .objectFit(ImageFit.Cover)
                  .borderRadius(8);
                Column({ space: 8, flexGrow: 1 }) {
                  Text(item.name)
                    .fontSize(18)
                    .fontWeight(Medium);
                  Row({ space: 5, alignItems: ItemAlign.Center }) {
                    Text(`${item.rating.toFixed(1)}`)
                      .fontSize(14)
                      .color("#ff3b30");
                    Text("★")
                      .fontSize(14)
                      .color("#ff3b30");
                    Text(item.distance)
                      .fontSize(14)
                      .color("#999999");
                  }
                  Button("导航")
                    .width(80)
                    .height(35)
                    .backgroundColor("#007aff")
                    .fontColor("#ffffff")
                    .borderRadius(17.5)
                    .alignSelf(ItemAlign.End);
                }
              }
            }
          }, (item) => item.name);
        }
        .padding({ left: 20, right: 20 });
      }
    }
    .width("100%")
    .backgroundColor("#f5f5f5")
  }
}

步骤5：免安装配置与打包

1. 免安装配置：在“build.gradle”中开启免安装模式：

ohos {
  compileSdkVersion 10
  defaultConfig {
    compatibleSdkVersion 10
    abilityType "atomic_service" // 声明为元服务
    freeInstall true // 开启免安装
  }
}
2. 打包发布：参考“鸿蒙应用测试与发布”流程，生成Release包后，提交至华为元服务平台，审核通过后即可实现免安装分发。

三、元服务分发与运营技巧

3.1 核心分发渠道

• 桌面卡片分发：用户通过“桌面空白处长按 > 添加卡片”选择元服务卡片，直接添加到桌面，是核心触达渠道；
• 扫码分发：生成元服务二维码，用户通过鸿蒙相机扫码直接启动，适用于线下场景（如餐厅、商场海报）；
• 应用市场分发：在华为应用市场“元服务专区”展示，用户搜索后可直接启动，无需安装；
• 碰一碰分发：通过NFC技术，用户手机碰一碰带有NFC标签的设备（如海报、设备），直接启动元服务。

3.2 运营优化技巧

• 卡片内容个性化：根据用户位置、使用习惯推送个性化内容（如早餐时间推荐早餐店），提升点击转化率；
• 轻量化交互设计：元服务核心流程需控制在3步内完成（如“查看餐厅 > 导航”），避免复杂操作；
• 数据驱动优化：通过华为元服务平台的“运营分析”工具，监控卡片点击量、启动率、留存率，优化卡片内容和服务流程；
• 场景化联动：与鸿蒙智联设备联动（如智能手表推送美食推荐，点击启动元服务），拓展使用场景。

四、总结

本文通过“本地美食推荐”元服务实战，详解了从服务卡片开发到免安装分发的全流程。元服务的核心优势在于“轻量触达”，开发重点需放在“卡片数据精准展示”和“服务流程轻量化”上。服务卡片作为用户第一触点，需通过个性化内容和简洁交互提升点击率；基础服务需保障核心功能流畅，避免冗余功能导致启动缓慢。

随着鸿蒙生态的完善，元服务将支持更多设备形态（如车机、智能屏），开发者可提前布局场景化服务，通过“卡片+服务”的组合形态，抢占生态红利。