# 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

## Introduction

The CellBroadcast application is mainly used to receive emergency messages and provide necessary alerts to users. Its key functions include:

1. Cell broadcast reception channel configuration
2. Alert settings
3. Historical message viewing
4. Message filtering
5. Channel management and control

## Architecture

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

## Directory

~~~
/CellBroadcast/
├── AppScope     # Global resources
│   └── resources
│       └── base
│           ├── element
│           └── media
├── common        # Common Module
│   └── src
│       └── main
│           ├── ets                 # ets code
│           │   ├── ability             # Directory of ability 
│           │   ├── alert               # Alarm ringing directory
│           │   ├── application         # Entry of application
│           │   ├── basecontroller      # Data controller for pop-up boxes and history pages
│           │   ├── channel             # Channel configuration acquisition and channel placement
│           │   ├── common              # Utils
│           │   ├── config              # Reads with card and network configurations
│           │   ├── database            # database
│           │   ├── messagefilter       # Message filter
│           │   ├── model               # Data entities
│           │   ├── notification        # Message notification of alarm
│           │   ├── settings            # Settings page
│           └── resources           # Directory of resources
├── product     # Directory of product code
│   ├── phone        # Code for phone
│   │   └── src
│   │       ├── main
│   │       │   ├── ets
│   │       │   │   ├── ability             # Ability directory for phone
│   │       │   │   ├── application         # Entry of phone
│   │       │   │   ├── component           # Customized Controls for phone settings page
│   │       │   │   ├── pages               # Phone pages
│   │       │   │   ├── search              # Settings search for phone
│   │       │   │   ├── utils               # Phone utils
│   │       │   └── resources          # Directory of resources for phone
│   │       ├── mock              # Mock data
│   │       └── ohosTest          # ohosTest
│   ├── wearable      # Code for wearable
│   │   └── src
│   │       └── main
│   │           ├── ets
│   │           │   ├── ability             # Ability directory for wearable
│   │           │   ├── application         # Entry of wearable
│   │           │   ├── component           # Customized Controls for wearable settings page
│   │           │   ├── pages               # Wearable pages
│   │           │   ├── utils               # Wearable utils
│   │           └── resources          # Directory of resources for Wearable
├── hvigor      # Compile build tool configuration
└── hw_sign     # signature configuration
~~~

## Build Guidance
Connect development board and open the project in DevEco Studio and choose Build > Build Haps(s)/APP(s) > Build Hap(s).

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

After the build is complete, a HAP file is generated in \build\outputs in the project directory. (If no signature is configured, an unsigned HAP file is generated.)

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

Run the `hdc shell bm get -u` command to get the UID of development board. Then copy the UID to `product/phone/sign-tool/UnsgnedDebugProfiler. json5` and `product/phone/sign-tool/UnsgnedDebugProfiler. json5`, as shown in the following figure:

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

Run the `hdc_std install "hap package address"` command to install the compiled HAP file.

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

## Constraints
OpenHarmony SDK API Version >= 16（Default is API Version 18）

Programming language：ArkTs

If developers are compiling code in a Windows environment, they need to replace the shell scripts (`sh`) in the following files with batch scripts (`bat`):

- `product/phone/hvigorfile.ts`
- `wearable/phone/hvigorfile.ts`

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

## Custom Development
The developer can customize the development of cellBroadcast by modifying the configuration file.

Directory of configuration file：src/main/resources/rawfile/cbs_config.json


## Related Code Repository
[telephony_sms_mms](https://gitee.com/openharmony/telephony_sms_mms)