applications_app_samples/README_zh.md

app_samples部件

简介

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

编码规范

社区共建Sample合入要求	代码规范	README编写规范
UI自动化用例编写规范	工程结构规范	PR提交格式规范

架构组成

一级分类	子分类	应用示例
UI	声明式开发范式	ArkTS组件集	媒体查询	状态管理
	类Web开发范式	Js组件集
基础特性	应用模型	Stage模型	Ability的启动方式	使用want分享数据
	通知	自定义Emitter	自定义通知	公共事件的订阅和发布
	窗口管理	窗口管理
	Web	浏览器	JS注入与执行
	媒体	图片显示及处理	视频播放	图片裁剪与分割
		录音机	二维码扫描
	安全	加解密	应用账号管理
	网络与连接	Http	RPC通信
	数据管理	首选项
	文件管理	文件管理	媒体管理合集
	设备管理	位置服务	屏幕探测	振动	传感器
		设备管理合集
	电话服务	拨打电话	SIM卡管理	短信	联系人
		网络和Sim卡状态订阅	蜂窝数据	网络搜索
	任务管理	后台代理提醒	延迟任务调度	资源调度接口使用	长时任务
		短时任务
	设备信息统计	设备使用信息统计
	DFX	Debug调试	测试打点	故障日志获取	日志打印
	国际化	资源管理
	IDL	Ability与ServiceExtensionAbility通信
系统特性	应用模型	仿桌面应用	任务管理	静态订阅	无障碍扩展
		企业设备管理扩展
	媒体	截屏	录屏
	安全	应用访问权限控制
	窗口管理	窗口扩展
	网络与连接	Wlan	蓝牙	上传
	数据管理	系统应用跨应用数据共享
	设备管理	系统电源管理	存储空间统计	屏幕属性
	国际化	时区和语言设置
关键特性	一次开发，多端部署	ArkTS一多能力集合	Js一多能力集合（Js）（API 8）	入门示例：天气应用	典型页面场景：健康饮食
		典型页面场景：应用市场首页	典型页面场景：音乐专辑页	典型页面场景：设置应用页面
	分布式	ArkTS分布式音乐播放	Js分布式音乐播放（Js）（API 9）	分布式计算器	分布式对象
		分布式关系型数据库	分布式数据管理	分布式组网认证
	卡片	Js多设备自适应服务卡片（Js）（API 8）	Stage模型卡片	Stage模型卡片JS与C++通信
行业解决方案	即时通信	聊天实例应用
	输入法	轻量级输入法
	电商	购物示例应用
	媒体	仿相机
	游戏	游戏2048	Lottie	分布式五子棋
	工具	图案密码锁	翻页时钟	Js时钟（Js）（API 9）	ArkTS时钟
工程能力	资源配置	应用主题切换
	应用程序包	多hap
语言基础类库	语言基础类库	语言基础类库	启动一个worker	压缩与解压

目录

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

code
|---UI                         # UI开发
  |---ArkTsComponentClollection    # ArkTs组件集
  |---JsComponentClollection       # 类Web开发范式组件集
|---BasicFeature               # 基础特性
  |---ApplicationModels            # 应用模型
  |---Notification                 # 通知
  |---WindowManagement             # 窗口管理
  |---Web                          # Web
  |---Media                        # 媒体
  |---Security                     # 安全
  |---Connectivity                 # 网络与连接
  |---DataManagement               # 数据管理
  |---FileManagement               # 文件管理
  |---Telephony                    # 电话服务
  |---TaskManagement               # 任务管理
  |---DeviceManagement             # 设备管理
  |---DeviceUsageStatistics        # 设备使用信息统计
  |---DFX                          # DFX
  |---Internationalnation          # 国际化
  |---IDL                          # IDL
|---SystemFeature              # 系统特性
  |---ApplicationModels            # 应用模型
  |---WindowManagement             # 窗口管理
  |---Media                        # 媒体
  |---Connectivity                 # 网络与连接
  |---DataManagement               # 数据管理
  |---DeviceManagement             # 设备管理
  |---Internationalnation          # 国际化
|---SuperFeature               # 关键特性
  |---MultiDeviceAppDev            # 一多
  |---DistributedAppDev            # 分布式
  |---Widget                       # 卡片
|---Solutions                  # 行业解决方案
  |---IM                           # 即时通信
  |---InputMethod                  # 输入法
  |---Shopping                     # 电商
  |---Media                        # 媒体
  |---Game                         # 游戏	
  |---Tools                        # 工具
|---Project                    # 工程能力
  |---ResourceAllocation           # 资源配置
  |---ApplicationHap               # 应用程序包
|---LaunguageBaseClassLibrary  # 语言基础类库

约束

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

使用方法

1. 将独立的应用示例工程导入DevEco Studio进行编译构建及运行调试。
2. 部分应用示例中含有多个模块，开发者可以选择对单个模块进行编译构建，生成一个HAP应用安装包，也可以对整个工程进行编译构建，生成多个HAP应用安装包。
3. 安装运行后，即可在设备上查看应用示例运行效果，以及进行相关调试。

Changlog

应用修改记录：changelog

releasenote

应用发布版本分支说明：releasenote

相关仓

1. app_sample 已废弃
2. applications_app_sample