# applications_cell_broadcast

**Repository Path**: openharmony-sig/applications_cell_broadcast

## Basic Information

- **Project Name**: applications_cell_broadcast
- **Description**: 小区广播开源
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/openharmony-sig/applications_cell_broadcast
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-05-26
- **Last Updated**: 2025-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# applications_cell_broadcast

## 简介

CellBroadcast应用主要功能为接收应急消息并向用户做出必要警示，主要功能包含小区广播接受频道设置、警报设置、历史消息查看、消息过滤、频道管控等功能。

## 架构图

![doc/image/img.png](doc/image/img.png)

## 目录

~~~
/CellBroadcast/
├── AppScope     # 全局资源
│   └── resources
│       └── base
│           ├── element
│           └── media
├── common        # 公共整体
│   └── src
│       └── main
│           ├── ets                 # ets代码目录
│           │   ├── ability             # ability目录
│           │   ├── alert               # 警报铃声
│           │   ├── application         # 应用入口
│           │   ├── basecontroller      # 弹框和历史记录界面的数据控制器
│           │   ├── channel             # 频道配置获取和频道下发
│           │   ├── common              # 工具类
│           │   ├── config              # 随卡和随网配置读取
│           │   ├── database            # 数据库
│           │   ├── messagefilter       # 消息过滤
│           │   ├── model               # 数据实体
│           │   ├── notification        # 警报消息通知
│           │   ├── settings            # 设置界面
│           └── resources           # 资源目录
├── product     # 产品代码目录
│   ├── phone        # 手机代码
│   │   └── src
│   │       ├── main
│   │       │   ├── ets
│   │       │   │   ├── ability             # 手机基础组件目录
│   │       │   │   ├── application         # 手机应用入口
│   │       │   │   ├── component           # 手机设置界面自定义控件
│   │       │   │   ├── pages               # 手机界面实现
│   │       │   │   ├── search              # 手机设置搜索
│   │       │   │   ├── utils               # 手机工具类
│   │       │   └── resources          # 手机资源目录
│   │       ├── mock              # ohos测试mock数据
│   │       └── ohosTest          # ohos测试
│   ├── wearable      # 穿戴代码
│   │   └── src
│   │       └── main
│   │           ├── ets
│   │           │   ├── ability             # 穿戴基础组件目录
│   │           │   ├── application         # 穿戴应用入口
│   │           │   ├── component           # 穿戴设置界面自定义控件
│   │           │   ├── pages               # 穿戴界面实现
│   │           │   ├── utils               # 穿戴工具类
│   │           └── resources          # 穿戴资源目录
├── hvigor      # 编译构建工具配置
└── hw_sign     # 签名配置
~~~

## 构建指导
连接开发板，在DevEco Studio打开项目工程，选择Build → Build Haps(s)/APP(s) → Build Hap(s)。

![doc/image/build_hap.png](doc/image/build_hap.png)

编译完成后，hap包会生成在工程目录下的 \build\outputs路径下。（如果没有配置签名，则只会生成未签名的hap包）

![doc/image/build_output_dir_release.png](doc/image/build_output_dir_release.png)

执行 `hdc shell bm get -u` 命令获取开发板uid，然后将uid复制到 `product/phone/sign-tool/UnsgnedDebugProfileTemplate.json5` 和 `product/phone/sign-tool/UnsgnedDebugProfileTemplate.json5中`，如下图所示：

![doc/image/device_id.png](doc/image/device_id.png)

执行 `hdc install "hap包地址"` 命令进行安装编译后的hap包。

![doc/image/cellbroadcast_install.png](doc/image/cellbroadcast_install.png)

## 约束
OpenHarmony SDK API Version >= 16 （默认为18）

编程语言：ArkTs

如果开发者在Windows环境下编译代码，需要将product/phone/hvigorfile.ts和wearable/phone/hvigorfile.ts中的sh脚本替换为bat脚本：

![doc/image/script.png](doc/image/script.png)

## 定制开发
开发者通过修改配置项可进行小区广播定制开发。
配置项路径：src/main/resources/rawfile/cbs_config.json


## 相关仓
[telephony_sms_mms](https://gitee.com/openharmony/telephony_sms_mms)