鸿蒙元服务-开发一个简单的气候应用
随着鸿蒙生态的不断美满，HarmonyOS 为开发者提供了全场景、多设备联动的本事。其中“元服务” (Service Widget 或 Ability Card) 是 HarmonyOS 特有的轻量级服务形态，可通过卡片的形式将应用的核心功能无缝呈现在多种设备上。此次，我们将以“简单气候应用”为例，展示如何利用鸿蒙元服务特性开发一款可在手机、平板、聪明屏等多种终端以卡片形式展示气候信息的应用。一、实现目标
我们的最终目标是实现一个气候查询卡片，用户无需进入完整应用界面，就能在主屏卡片中实时查看当前都会的气候状况、温度以及气候图标。
核心功能点：
[*]提供当前地理位置气候查询（示例以固定都会或内置坐标为例）。
[*]展示气候卡片：包罗都会名称、当前温度、气候图标和简短描述。
[*]支持轻量级交互，如点击卡片革新气候。
二、开发环境预备
1. 开发工具安装
[*]DevEco Studio: 华为官方提供的集成开发环境，下载所在可参考华为开发者官网。
[*]HarmonyOS SDK: 可通过 DevEco Studio 内置 SDK Manager 下载对应版本的鸿蒙 SDK。
[*]开发者账号与设备（可选）: 若需在真机或鸿蒙模拟器中运行，必要有华为开发者账号并启用相应权限。
2. 项目初始化
打开 DevEco Studio：
[*]创建新工程：选择 “File” -> “New” -> “HarmonyOS Project”。
[*]选择模板：选择 Empty Feature Ability 模板（FA 模板），这样可以方便后续创建元服务卡片。
[*]输入项目信息，如名称：SimpleWeather，包名：com.example.simpleweather，并选择合适的 API Level。
创建完毕后，DevEco Studio 将自动天生基础的目录布局。
3. 元服务（Service Widget）配置
在鸿蒙中，元服务通常以 Ability 的形式存在，并通过 config.json 或 module.json5 等配置文件来声明。我们必要在项目标 module.json5 中添加元服务相干的配置。
示例配置（请根据实际版本和目录布局微调）：
{
"module": {
"type": "entry",
"name": "entry",
"abilities": [
{
"name": "WeatherServiceAbility",
"type": "service",
"skills": [],
"forms": [
{
"name": "WeatherWidget",
"description": "Display simple weather info",
"dimensions": [
{
"id": 1,
"width": 2,
"height": 2
}
],
"defaultDimension": 1,
"jsComponent": true
}
]
}
]
}
}
这里声明了一个 Service Ability（WeatherServiceAbility）和对应的一项元服务卡片（WeatherWidget）。
三、代码实现
1. 数据来源与网络请求
气候数据可以通过公开的气候 API 获取，如 OpenWeatherMap（需注册获取 API Key）。为简化演示，这里假定我们有一个简单的 API 调用函数。
在 entry/src/main/js/default/common/utils/weatherRequest.js 文件中编写：
import fetch from '@ohos.net.fetch';
const API_URL = "https://api.openweathermap.org/data/2.5/weather?q=Beijing&units=metric&appid=YOUR_API_KEY";
export async function getWeatherInfo() {
try {
const response = await fetch.fetch(API_URL);
const json = await response.json();
return {
city: json.name,
temp: Math.round(json.main.temp),
description: json.weather.description,
icon: json.weather.icon
};
} catch (e) {
console.error("Failed to fetch weather:", e);
return null;
}
}
2. 卡片布局编写
在鸿蒙中，元服务卡片利用 Declarative UI 或 XML 布局。以 Declarative UI 为例，在 entry/src/main/js/default/pages/CardForm.js 中：
import { getWeatherInfo } from '../common/utils/weatherRequest.js'
export default {
data: {
city: "Loading...",
temp: "--",
description: "N/A",
iconUrl: ""
},
onInit() {
this.loadWeather();
},
async loadWeather() {
const info = await getWeatherInfo();
if(info) {
this.city = info.city;
this.temp = info.temp + "°C";
this.description = info.description;
// 使用OpenWeatherMap的图标链接
this.iconUrl = `http://openweathermap.org/img/wn/${info.icon}@2x.png`;
}
},
refresh() {
this.loadWeather();
}
}
对应的 UI 布局文件（entry/src/main/js/default/pages/CardForm.hml）示例：
<template>
<div class="container">
<div class="city">{{city}}</div>
<image src="{{iconUrl}}" class="icon"/>
<div class="temp">{{temp}}</div>
<div class="desc">{{description}}</div>
<button class="refresh-btn" @click="refresh">刷新</button>
</div>
</template>
样式文件（CardForm.css）简单示例：
.container {
flex-direction: column;
justify-content: center;
align-items: center;
}
.city {
font-size: 24px;
margin-bottom: 10px;
}
.temp {
font-size: 40px;
font-weight: bold;
margin-top: 10px;
}
.desc {
font-size: 18px;
margin-top: 5px;
}
.icon {
width: 50px;
height: 50px;
margin: 10px;
}
.refresh-btn {
margin-top: 15px;
padding: 10px;
background-color: #5B8FF9;
color: #ffffff;
border-radius: 5px;
}
3. Ability 与 Card 关联
在 entry/src/main/js/default/app.js 中注册卡片路由：
export default {
onCreate() {
console.info('Application onCreate');
},
onDestroy() {
console.info('Application onDestroy');
}
}
在 entry/src/main/js/default/ability/WeatherServiceAbility.js 中，创建 service ability 并注册卡片数据源：
import Ability from '@ohos.application.Ability'
export default class WeatherServiceAbility extends Ability {
onCreate(want, launchParam) {
console.info('WeatherServiceAbility onCreate');
}
onRequestForm(formId, formParams) {
console.info('WeatherServiceAbility onRequestForm');
// 返回卡片页面
return {
template: 'CardForm'
};
}
}
确保在 module.json5 配置中已指定 WeatherServiceAbility 所提供的卡片模板为 CardForm。
四、调试与摆设
1. 模拟器调试
DevEco Studio 提供 HarmonyOS 模拟器大概可以连接鸿蒙设备。点击运行按钮选择合适的设备即可摆设运行。
成功后，在主屏添加卡片，在可用卡片列表中应能看到 “SimpleWeather” 的卡片，添加后显示实时气候信息。
2. 真机调试
将鸿蒙手机或平板通过 USB 连接到开发电脑，开启开发者模式。在 DevEco Studio 中选择目标设备为真实硬件，摆设运行。
五、常见问题与解决方案
[*] 气候数据无法获取？
[*]检查网络权限与 API Key 是否正确，以及设备是否可以大概访问外网。
[*]在 module.json5 中添加网络权限声明。
[*] 卡片无法正常显示布局？
[*]确保 CardForm.hml、CardForm.css、CardForm.js 文件路径和定名与配置中一致。
[*]检查 WeatherServiceAbility 的 onRequestForm 方法返回的模板名称是否正确。
[*] 革新不生效？
[*]查看 loadWeather 方法是否正确革新 data 数据。
[*]确保 button 的点击事件被正确绑定。
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]