鸿蒙APP开发：服务联邦跨服务无缝打通

内容承接与核心价值

这是《鸿蒙APP开发从入门到精通》的第8篇——服务联邦篇，承接第7篇的「超级终端多设备协同开发」，100%复用项目架构，为后续第9-12篇的电商购物车全栈项目铺垫服务联邦跨服务无缝打通的核心技术。

学习目标：

• 掌握服务联邦跨服务无缝打通的定义与架构；
• 实现商品搜索与购物车两个核心业务场景的跨服务无缝打通；
• 理解服务联邦的原理与实现方式；
• 开发跨服务通信与跨服务数据同步两个核心功能；
• 优化跨服务无缝打通的用户体验（服务发现、连接、数据同步）。

学习重点：

• 服务联邦跨服务无缝打通的开发流程；
• 服务联邦的分类与使用场景；
• 跨服务通信与跨服务数据同步的实现；
• 服务联邦的服务发现与连接。

一、服务联邦跨服务无缝打通基础

1.1 定义

服务联邦跨服务无缝打通是HarmonyOS Next推出的一种全新应用形态，具有以下特点：

• 跨服务联动：通过服务联邦，用户可以将不同应用的服务连接在一起；
• 无缝体验：在不同应用间实现服务调用、数据同步、任务共享；
• 场景化应用：针对特定业务场景设计，提供单一功能；
• 跨应用操作：支持在不同应用间进行文件传输、视频通话、游戏互动等操作。

1.2 架构

服务联邦跨服务无缝打通采用分布式架构，由以下部分组成：

• 跨服务通信：负责服务间的通信与数据传输；
• 跨服务数据同步：负责数据的存储、同步与共享；
• 跨服务任务调度：负责任务的分配与执行；
• 跨服务UI组件：负责跨服务间的UI布局与交互。

二、服务联邦跨服务无缝打通实战

2.1 实战目标

基于第7篇的「MyFirstHarmonyApp」项目架构，实现以下功能：

• 商品搜索跨服务无缝打通：在其他应用中搜索商品，在MyFirstHarmonyApp中查看商品详情；
• 购物车跨服务无缝打通：在其他应用中添加商品到购物车，在MyFirstHarmonyApp中查看购物车商品；
• 跨服务通信：实现不同应用间的通信与数据传输；
• 跨服务数据同步：实现商品搜索记录与购物车数据的同步。

2.2 项目结构调整

在「entry/src/main/ets」目录下创建以下文件夹：

• federated：存放服务联邦相关代码；
• ui：存放跨服务UI组件相关代码。

2.3 跨服务通信实现

1. 跨服务通信工具类

entry/src/main/ets/utils/FederatedCommunicationManager.ets

import communication from '@ohos.federatedCommunication';
import { UIAbilityContext } from '@ohos.abilityAccessCtrl';

// 跨服务通信工具类
export class FederatedCommunicationManager {
  private static instance: FederatedCommunicationManager | null = null;
  private communicationHelper: communication.FederatedCommunicationHelper | null = null;

  // 单例模式
  static getInstance(): FederatedCommunicationManager {
    if (!FederatedCommunicationManager.instance) {
      FederatedCommunicationManager.instance = new FederatedCommunicationManager();
    }
    return FederatedCommunicationManager.instance;
  }

  // 初始化跨服务通信
  async init(context: UIAbilityContext): Promise<void> {
    if (!this.communicationHelper) {
      this.communicationHelper = communication.createFederatedCommunicationHelper(context);
    }
  }

  // 发现服务
  onServiceFound(callback: (service: communication.FederatedServiceInfo) => void): void {
    if (!this.communicationHelper) {
      return;
    }
    this.communicationHelper.on('serviceFound', (service: communication.FederatedServiceInfo) => {
      callback(service);
    });
  }

  // 取消发现服务
  offServiceFound(callback: (service: communication.FederatedServiceInfo) => void): void {
    if (!this.communicationHelper) {
      return;
    }
    this.communicationHelper.off('serviceFound', callback);
  }

  // 连接服务
  async connectService(serviceId: string): Promise<boolean> {
    if (!this.communicationHelper) {
      return false;
    }
    const result = await this.communicationHelper.connect(serviceId);
    return result === communication.ConnectResult.SUCCESS;
  }

  // 断开服务连接
  async disconnectService(serviceId: string): Promise<boolean> {
    if (!this.communicationHelper) {
      return false;
    }
    const result = await this.communicationHelper.disconnect(serviceId);
    return result === communication.DisconnectResult.SUCCESS;
  }

  // 发送消息
  async sendMessage(serviceId: string, message: string): Promise<boolean> {
    if (!this.communicationHelper) {
      return false;
    }
    const result = await this.communicationHelper.sendMessage(serviceId, message);
    return result === communication.SendResult.SUCCESS;
  }

  // 接收消息
  onMessageReceived(callback: (serviceId: string, message: string) => void): void {
    if (!this.communicationHelper) {
      return;
    }
    this.communicationHelper.on('messageReceived', (serviceId: string, message: string) => {
      callback(serviceId, message);
    });
  }

  // 取消接收消息
  offMessageReceived(callback: (serviceId: string, message: string) => void): void {
    if (!this.communicationHelper) {
      return;
    }
    this.communicationHelper.off('messageReceived', callback);
  }
}

2. 跨服务通信应用

entry/src/main/ets/components/ServiceListComponent.ets

import { FederatedCommunicationManager } from '../utils/FederatedCommunicationManager';
import { communication } from '@ohos.federatedCommunication';

@Component
export struct ServiceListComponent {
  @State serviceList: Array<communication.FederatedServiceInfo> = [];
  @State connectedServiceId: string = '';

  build() {
    Column({ space: 16 }) {
      Text('已连接服务')
        .fontSize(18)
        .fontWeight(FontWeight.Bold)
        .textColor('#000000');
      List({ space: 16 }) {
        ForEach(this.serviceList, (service: communication.FederatedServiceInfo) => {
          ListItem() {
            Row({ space: 16 }) {
              Image(service.icon)
                .width(40)
                .height(40)
                .objectFit(ImageFit.Contain);
              Column({ space: 8 }) {
                Text(service.name)
                  .fontSize(14)
                  .fontWeight(FontWeight.Bold)
                  .textColor('#000000');
                Text(service.description)
                  .fontSize(14)
                  .textColor('#666666');
              }.layoutWeight(1);
              if (service.id === this.connectedServiceId) {
                Text('已连接')
                  .fontSize(14)
                  .textColor('#007DFF');
              } else {
                Button('连接')
                  .width(80)
                  .height(40)
                  .backgroundColor('#007DFF')
                  .onClick(async () => {
                    const result = await FederatedCommunicationManager.getInstance().connectService(service.id);
                    if (result) {
                      this.connectedServiceId = service.id;
                    }
                  });
              }
            }
            .width('100%')
            .height('auto')
            .padding(16)
            .backgroundColor('#FFFFFF')
            .borderRadius(12);
          }
          .width('100%')
          .height('auto');
        }, (service: communication.FederatedServiceInfo) => service.id);
      }
      .width('100%')
      .height('auto')
      .padding(16);

      Text('可连接服务')
        .fontSize(18)
        .fontWeight(FontWeight.Bold)
        .textColor('#000000');
      List({ space: 16 }) {
        // 可连接服务列表
      }
      .width('100%')
      .height('auto')
      .padding(16);
    }
    .width('100%')
    .height('100%')
    .backgroundColor('#F5F5F5');
  }

  aboutToAppear() {
    // 监听服务发现
    FederatedCommunicationManager.getInstance().onServiceFound((service: communication.FederatedServiceInfo) => {
      this.serviceList.push(service);
    });
  }
}

2.4 跨服务数据同步实现

1. 跨服务数据同步工具类

entry/src/main/ets/utils/FederatedDataManager.ets

import dataShare from '@ohos.data.dataShare';
import { UIAbilityContext } from '@ohos.abilityAccessCtrl';

// 跨服务数据同步工具类
export class FederatedDataManager {
  private static instance: FederatedDataManager | null = null;
  private dataShareHelper: dataShare.DataShareHelper | null = null;

  // 单例模式
  static getInstance(): FederatedDataManager {
    if (!FederatedDataManager.instance) {
      FederatedDataManager.instance = new FederatedDataManager();
    }
    return FederatedDataManager.instance;
  }

  // 初始化跨服务数据同步
  async init(context: UIAbilityContext): Promise<void> {
    if (!this.dataShareHelper) {
      const uri = 'dataability://com.example.myapp';
      this.dataShareHelper = await dataShare.createDataShareHelper(context, uri);
    }
  }

  // 保存数据
  async saveData(key: string, value: any): Promise<void> {
    if (!this.dataShareHelper) {
      return;
    }
    await this.dataShareHelper.insert('data', { key, value });
  }

  // 获取数据
  async getData(key: string): Promise<any> {
    if (!this.dataShareHelper) {
      return null;
    }
    const result = await this.dataShareHelper.query('data', { key });
    if (result && result.length > 0) {
      return result[0].value;
    }
    return null;
  }

  // 删除数据
  async deleteData(key: string): Promise<void> {
    if (!this.dataShareHelper) {
      return;
    }
    await this.dataShareHelper.delete('data', { key });
  }

  // 监听数据变化
  onDataChange(key: string, callback: (value: any) => void): void {
    if (!this.dataShareHelper) {
      return;
    }
    this.dataShareHelper.on('dataChange', (data: any) => {
      if (data.key === key) {
        callback(data.value);
      }
    });
  }

  // 取消监听数据变化
  offDataChange(key: string, callback: (value: any) => void): void {
    if (!this.dataShareHelper) {
      return;
    }
    this.dataShareHelper.off('dataChange', callback);
  }
}

2. 跨服务数据同步应用

entry/src/main/ets/services/SearchService.ets（修改）

import { FederatedDataManager } from '../utils/FederatedDataManager';

// 搜索服务
export class SearchService {
  // ...

  // 保存搜索记录
  async saveSearchHistory(keyword: string): Promise<void> {
    const history = await this.getSearchHistory();
    const index = history.findIndex(item => item === keyword);
    if (index !== -1) {
      history.splice(index, 1);
    }
    history.unshift(keyword);
    if (history.length > 10) {
      history.splice(10);
    }
    await FederatedDataManager.getInstance().saveData('searchHistory', history);
  }

  // 获取搜索记录
  async getSearchHistory(): Promise<Array<string>> {
    const history = await FederatedDataManager.getInstance().getData('searchHistory');
    return history || [];
  }

  // 删除搜索记录
  async deleteSearchHistory(keyword: string): Promise<void> {
    const history = await this.getSearchHistory();
    const index = history.findIndex(item => item === keyword);
    if (index !== -1) {
      history.splice(index, 1);
      await FederatedDataManager.getInstance().saveData('searchHistory', history);
    }
  }

  // 清空搜索记录
  async clearSearchHistory(): Promise<void> {
    await FederatedDataManager.getInstance().deleteData('searchHistory');
  }
}

entry/src/main/ets/services/CartService.ets（修改）

import { FederatedDataManager } from '../utils/FederatedDataManager';

// 购物车服务
export class CartService {
  // ...

  // 添加商品到购物车
  async addToCart(productId: number, count: number): Promise<void> {
    const cartItems = await this.getCartItems();
    const index = cartItems.findIndex(item => item.productId === productId);
    if (index !== -1) {
      cartItems[index].count += count;
    } else {
      const product = goodsData.find(item => item.id === productId);
      if (product) {
        cartItems.push({ id: productId, productId, name: product.name, imageUrl: product.imageUrl, price: product.price, count, isChecked: false });
      }
    }
    await this.saveCartItems(cartItems);
    // 同步到跨服务数据管理
    await FederatedDataManager.getInstance().saveData('cartItems', cartItems);
  }

  // 获取购物车商品
  async getCartItems(): Promise<Array<CartItemModel>> {
    // 先从跨服务数据管理获取
    const remoteData = await FederatedDataManager.getInstance().getData('cartItems');
    if (remoteData) {
      return remoteData;
    }
    // 跨服务数据管理无数据，从本地数据库获取
    const localData = await this.getCartItemsFromLocal();
    return localData;
  }

  // 删除购物车商品
  async deleteCartItem(id: number): Promise<void> {
    const cartItems = await this.getCartItems();
    const index = cartItems.findIndex(item => item.id === id);
    if (index !== -1) {
      cartItems.splice(index, 1);
      await this.saveCartItems(cartItems);
      // 同步到跨服务数据管理
      await FederatedDataManager.getInstance().saveData('cartItems', cartItems);
    }
  }

  // 清空购物车
  async clearCart(): Promise<void> {
    await this.saveCartItems([]);
    // 同步到跨服务数据管理
    await FederatedDataManager.getInstance().saveData('cartItems', []);
  }
}

三、项目配置与部署

3.1 配置文件修改

1. module.json5 修改

在「entry/src/main/module.json5」中添加服务联邦配置：

{
  "module": {
    "requestPermissions": [
      { "name": "ohos.permission.DISTRIBUTED_DATASYNC" },
      { "name": "ohos.permission.DISTRIBUTED_COMMUNICATION" },
      { "name": "ohos.permission.GET_NETWORK_INFO" },
      { "name": "ohos.permission.READ_EXTERNAL_STORAGE" },
      { "name": "ohos.permission.WRITE_EXTERNAL_STORAGE" }
    ],
    "abilities": [],
    "widgets": [],
    "pages": []
  }
}

3.2 项目部署

1. 在DevEco Studio中点击「Build」→「Build HAP」，编译项目。
2. 将编译后的HAP文件部署到鸿蒙设备上。
3. 测试跨服务无缝打通：
   • 在其他应用中搜索商品，在MyFirstHarmonyApp中查看商品详情；
   • 在其他应用中添加商品到购物车，在MyFirstHarmonyApp中查看购物车商品。

四、项目运行与效果验证

4.1 效果验证

✅ 跨服务无缝打通：在其他应用中搜索商品，在MyFirstHarmonyApp中查看商品详情；
✅ 数据同步：购物车数据在不同应用间同步；
✅ 服务发现：自动发现附近的鸿蒙应用服务；
✅ 服务连接：手动连接附近的鸿蒙应用服务。

五、总结与未来学习路径

5.1 总结

本文完成了：

• 服务联邦跨服务无缝打通的定义与架构；
• 商品搜索与购物车两个核心业务场景的跨服务无缝打通实现；
• 跨服务通信与跨服务数据同步的原理与实现方式；
• 服务联邦的服务发现与连接。

5.2 未来学习路径

• 第9篇：安全加固与组件化架构；
• 第10篇：AI原生与用户增长；
• 第11篇：性能优化与Next原生合规；
• 第12篇：运维监控、生态运营与专属变现。