README_zh.md · yanglifeng/applications_app_samples

# app_samples部件<a name="ZH-CN_TOPIC_0000001115464207"></a>

## 简介<a name="section1470103520301"></a>

为帮助开发者快速熟悉OpenHarmony SDK所提供的API和应用开发流程，我们提供了一系列的应用示例，即Sample。每一个应用示例都是一个独立的DevEco Studio工程项目，开发者可以将工程导入到DevEco Studio开发工具，通过浏览代码、编译工程、安装和运行应用示例来了解应用示例中涉及API的使用方法。

**编码规范**

<!--

【示例贡献温馨提示】感谢您关注OpenHarmony，如果您希望提交代码样例/示例/Demo，请参考知识体系的[《如何共建开发样例》](https://gitee.com/openharmony-sig/knowledge/blob/master/docs/co-construct_demos/README_zh.md)，首先提交到SIG（兴趣组）仓，知识体系SIG仓中的提交也是有效贡献。再次感谢您的关注！)

-->

<table width="990" border="0" cellpadding="0" cellspacing="0" style='border-collapse:collapse;table-layout:fixed;'>
 <tr height="18" style='height:13.50pt;'>
 <td width="330"><a href="CodeCommitChecklist.md#社区共建Sample合入要求" target="_blank">社区共建Sample合入要求</a></td>
 <td width="330"><a href="CodeCommitChecklist.md#代码规范" target="_blank">代码规范</a></td>
 <td width="330"><a href="CodeCommitChecklist.md#readme编写规范" target="_blank">README编写规范</a></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td width="330"><a href="CodeCommitChecklist.md#ui自动化用例编写规范" target="_blank">UI自动化用例编写规范</a></td>
 <td width="330"><a href="CodeCommitChecklist.md#工程结构规范" target="_blank">工程结构规范</a></td>
 <td width="330"><a href="CodeCommitChecklist.md#pr提交格式规范" target="_blank">PR提交格式规范</a></td>
 </tr>
</table>

**架构组成**

<table width="990" border="0" cellpadding="0" cellspacing="0" style='border-collapse:collapse;table-layout:fixed;'>
 <tr height="18" style='height:13.50pt;'>
 <td width="140" x:str>一级分类</td>
 <td width="170" x:str>子分类</td>
 <td width="680" colspan="4" align="center" x:str>应用示例</td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td width="140" align="center" rowspan="2" style='height:27.00pt' x:str>UI</td>
 <td width="170" x:str>声明式开发范式</td>
 <td width="170" x:str><a href="ETSUI/ComponentCollection">ArkTS组件集</a></td>
 <td width="170" x:str><a href="ETSUI/MediaQuery">媒体查询</a></td>
 <td width="170"></td>
 <td width="170"></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>类Web开发范式</td>
 <td x:str><a href="UI/JsComponentCollection">Js组件集</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td height="270" align="center" rowspan="19" style='height:202.50pt' x:str>基础特性</td>
 <td x:str>应用模型</td>
 <td x:str><a href="ability/FaModel">FA模型</a></td>
 <td x:str><a href="ability/StageModel">Stage模型</a></td>
 <td x:str><a href="ability/AbilityStartMode">Ability的启动方式</a></td>
 <td x:str><a href="Share/CustomShare">使用want分享数据</a></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>通知</td>
 <td x:str><a href="Notification/CustomEmitter">自定义Emitter</a></td>
 <td x:str><a href="Notification/CustomNotification">自定义通知</a></td>
 <td x:str><a href="Notification/CustomCommonEvent">公共事件的订阅和发布</a></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>窗口管理</td>
 <td x:str><a href="Graphics/WindowManage">窗口管理</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>Web</td>
 <td x:str><a href="device/Browser">浏览器</a></td>
 <td x:str><a href="Web/RunJsInWeb">JS注入与执行</a></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td rowspan="2" x:str>媒体</td>
 <td x:str><a href="media/Image">图片显示及处理</a></td>
 <td x:str><a href="media/VideoShow">视频播放</a></td>
 <td x:str><a href="media/GamePuzzle">图片裁剪与分割</a></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str><a href="media/Recorder">录音机</a></td>
 <td x:str><a href="media/QRCodeScan">二维码扫描</a></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>安全</td>
 <td x:str><a href="Safety/Cipher">加解密</a></td>
 <td ><a href="Account/AppAccountManager">应用账号管理</a></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>网络与连接</td>
 <td x:str><a href="Network/Http">Http</a></td>
 <td x:str><a href="Communication/RPC">RPC通信</a></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>数据管理</td>
 <td x:str><a href="data/Preferences">首选项</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>文件管理</td>
 <td x:str><a href="FileManager/FileManager">文件管理</a></td>
 <td x:str><a href="media/MediaCollections">媒体管理合集</a></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td rowspan="2" x:str>设备管理</td>
 <td x:str><a href="device/USBManager">USB管理</a></td>
 <td x:str><a href="device/Location">位置服务</a></td>
 <td x:str><a href="device/ScreenDetector">屏幕探测</a></td>
 <td x:str><a href="device/Vibrator">振动</a></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str><a href="device/Sensor">传感器</a></td>
 <td x:str><a href="common/Runninglock">运行锁</a></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td rowspan="2" x:str>电话服务</td>
 <td x:str><a href="Telephony/Call">拨打电话</a></td>
 <td x:str><a href="Telephony/SimManager">SIM卡管理</a></td>
 <td x:str><a href="Telephony/Message">短信</a></td>
 <td x:str><a href="Telephony/Contact">联系人</a></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str><a href="Telephony/Observer">网络和Sim卡状态订阅</a></td>
 <td x:str><a href="Telephony/MobileNetwork">蜂窝数据</a></td>
 <td x:str><a href="Telephony/RadioTech">网络搜索</td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>任务管理</td>
 <td x:str><a href="ResourcesSchedule/ReminderAgentManager">后台代理提醒</a></td>
 <td x:str><a href="ResourcesSchedule/WorkScheduler">延迟任务调度</a></td>
 <td x:str><a href="ResourcesSchedule/PlayMusicBackground">后台播放音乐</a></td>
 <td x:str><a href="ResourcesSchedule/Flybird">资源调度接口使用</a></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>设备信息统计</td>
 <td x:str><a href="device/DeviceUsageStatistics">设备使用信息统计</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>DFX</td>
 <td x:str><a href="DFX/Debug">Debug调试</a></td>
 <td ><a href="DFX/JsDotTest">测试打点</a></td>
 <td ><a href="DFX/FaultLogger">故障日志获取</a></td>
 <td ><a href="DFX/Logger">日志打印</a></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>国际化</td>
 <td x:str><a href="common/ResourceManager">资源管理</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>IDL</strong</td>
 <td x:str><a href="ability/AbilityConnectServiceExtension">Ability与ServiceExtensionAbility通信</a></td>
 <td x:str></td>
 <td x:str></td>
 <td x:str></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td height="90" align="center" rowspan="8" style='height:67.50pt;' x:str>系统特性（Full SDK）</td>
 <td x:str>应用模型</td>
 <td x:str><a href="ability/Launcher">仿桌面应用</a></td>
 <td x:str><a href="ability/MissionManager">任务管理</a></td>
 <td x:str><a href="ability/StaticSubscriber">静态订阅</a></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>媒体</td>
 <td x:str><a href="Basic/Screenshot">截屏</a></td>
 <td x:str><a href="media/ScreenRecorder">录屏</a></td>
 <td ></td>
 <td ></td>
 </tr>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>安全</td>
 <td x:str><a href="Safety/AbilityAccessCtrl">应用访问权限控制</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>窗口管理</td>
 <td x:str><a href="ability/WindowExtAbility">窗口扩展</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>网络与连接</td>
 <td x:str><a href="Communication/Wlan">Wlan</a></td>
 <td x:str><a href="device/Bluetooth">蓝牙</a></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>数据管理</td>
 <td x:str><a href="data/CrossAppDataShare">系统应用跨应用数据共享</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>设备管理</td>
 <td x:str><a href="common/PowerManager">系统电源管理</a></td>
 <td x:str><a href="FileManager/StorageStatistic">存储空间统计</a></td>
 <td x:str><a href="device/Screen">屏幕属性</a></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>国际化</td>
 <td x:str><a href="common/International">时区和语言设置</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 <tr height="18" style='height:13.50pt;'>
 <td height="90" align="center" rowspan="5" style='height:67.50pt;' x:str>关键特性</td>
 <td rowspan="2" x:str>一次开发，多端部署</td>
 <td x:str><a href="ETSUI/HealthyDiet">一多健康饮食</a></td>
 <td x:str><a href="MultiDeviceAppDev/AdaptiveCapabilities">ArkTS多设备自适应能力</a></td>
 <td x:str><a href="MultiDeviceAppDev/JsAdaptiveCapabilities">Js多设备自适应能力（Js）（API 8）</a></td>
 <td x:str><a href="MultiDeviceAppDev/AppMarket">一多应用市场首页</a></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str><a href="MultiDeviceAppDev/MusicAlbum">一多音乐专辑主页</a></td>
 <td x:str><a href="MultiDeviceAppDev/Weather">一多天气</a></td>
 <td x:str><a href="MultiDeviceAppDev/Settings">一多设置</a></td>
 <td x:str><a href="UI/JsAdaptivePortalPage">Js一多页面</a></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td rowspan="2" x:str>分布式</td>
 <td x:str><a href="Preset/DistributedMusicPlayer">ArkTS分布式音乐播放</a></td>
 <td x:str><a href="ability/JsDistributedMusicPlayer">Js分布式音乐播放（Js）（API 9）</a></td>
 <td x:str><a href="Preset/EtsDistributedCalc">分布式计算器</a></td>
 <td x:str><a href="data/DistributedNote">分布式对象</a></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str><a href="data/DistributedRdb">分布式关系型数据库库</a></td>
 <td x:str><a href="data/DistributedDataGobang">分布式数据管理</a></td>
 <td x:str><a href="device/DeviceManager">分布式组网认证</a></td>
 <td x:str></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>卡片</td>
 <td x:str><a href="UI/JsAdaptiveServiceWidget">Js多设备自适应服务卡片（Js）（API 8）</a></td>
 <td x:str><a href="ability/FormExtAbility">Stage模型卡片</a></td>
 <td x:str><a href="ability/FormGame">Stage模型卡片JS与C++通信</a></td>
 <td></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td height="90" align="center" rowspan="5" style='height:67.50pt' x:str>行业解决方案</td>
 <td x:str>即时通信</td>
 <td x:str><a href="AppSample/Chat">聊天实例应用</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>输入法</td>
 <td x:str><a href="CompleteApps/KikaInput">轻量级输入法</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>电商</td>
 <td x:str><a href="ETSUI/OrangeShopping">购物示例应用</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>游戏</td>
 <td x:str><a href="ETSUI/Game2048">游戏2048</a></td>
 <td x:str><a href="ETSUI/Lottie">Lottie</a></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>工具</td>
 <td x:str><a href="ETSUI/PatternLock">图案密码锁</a></td>
 <td x:str><a href="CompleteApps/FlipClock">翻页时钟</a></td>
 <td x:str><a href="common/Clock">Js时钟（Js）（API 9）</a></td>
 <td x:str><a href="Preset/Clock">ArkTS时钟</a></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td height="54" align="center" rowspan="3" style='height:40.50pt' x:str>工程能力</td>
 <td x:str>资源配置</td>
 <td x:str><a href="ETSUI/ApplicationThemeSwitch">应用主题切换</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>三方库使用</td>
 <td x:str><a href="EngineeringCapability/Npm">npm的使用</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td x:str>应用程序包</td>
 <td x:str><a href="bundle/MultiHap">多hap</a></td>
 <td ></td>
 <td ></td>
 <td ></td>
 </tr>
 <tr height="18" style='height:13.50pt;'>
 <td rowspan="3" align="center" x:str>语言基础类库</td>
 <td rowspan="3" x:str>语言基础类库</td>
 <td x:str><a href="Util/UtilBase64Codec">Base64编解码</a></td>
 <td x:str><a href="Util/UtilLruBuffer">缓冲区</a></td>
 <td x:str><a href="Util/UtilRationalNumber">有理数</a></td>
 <td x:str><a href="Util/UtilScope">范围判断</a></td>
 </tr>
 <tr>
 <td x:str><a href="Util/UtilStringCodec">字符串编解码</a></td>
 <td x:str><a href="Util/UtilTypeCheck">内置对象类型检查</a></td>
 <td x:str><a href="Util/UtilUrlString">URL字符串解析</a></td>
 <td x:str><a href="Util/XmlTextConvert">xml文本转换</a></td>
 </tr>
 <tr>
 <td x:str><a href="Basic/Container">线性容器ArrayList</a></td>
 <td x:str><a href="thread/JsWorker">启动一个worker</a></td>
 <td x:str><a href="PackageManagement/ZipLib">压缩与解压</a></td>
 <td x:str><a href="ETSUI/Process">进程信息</a></td>
 </tr>
 <tr>
 <![if supportMisalignedColumns]>
 <tr height="18" style="display:none;">
 </tr>
 <![endif]>
</table>

## 目录<a name="sectionMenu"></a>

Sample仓下所展示的组件能力：

## 约束<a name="section18841871178"></a>

安装应用示例之前，请先查看"README_zh.md"文件来确认应用示例是否为stage模型，若为Stage模型需要查看entry/src/main路径下的module.json5文件中的"deviceType"字段来确认该应用支持的设备类型；否则为FA模型，查看entry/src/main路径下的config.json文件中的"deviceType"字段来确认该应用示例支持的设备类型，两种模型都可尝试通过修改该字段使其可以在相应类型的设备上运行。

## 使用方法<a name="section17988202503116"></a>

1.  本仓默认下载全量工程代码，如需下载单个应用工程代码，请先下载并执行工具[【Windows版本】](DirCloneTool/CloneSpecifyDirForWindows.bat)、[【macOS版本】]()、[【Linux版本】]()
2.  将独立的应用示例工程导入DevEco Studio进行编译构建及运行调试。
3.  部分应用示例中含有多个模块，开发者可以选择对单个模块进行编译构建，生成一个HAP应用安装包，也可以对整个工程进行编译构建，生成多个HAP应用安装包。
4.  安装运行后，即可在设备上查看应用示例运行效果，以及进行相关调试。

## Changlog<a name="section17988202503117"></a>

应用修改记录：[changelog](changelog.md)

## releasenote

应用发布版本分支说明：[releasenote](releasenote.md)

## 相关仓<a name="section17988202503118"></a>

1. [app_sample](https://gitee.com/openharmony/app_samples) 已废弃
2. [applications_app_sample](https://gitee.com/openharmony/applications_app_samples)

yanglifeng/applications_app_samples

简介

发行版

贡献者

近期动态

yanglifeng/applications_app_samples .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

yanglifeng/applications_app_samples