app_samples部件

简介

【示例贡献温馨提示】感谢您关注OpenHarmony，如果您希望提交代码样例/示例/Demo，请参考知识体系的《如何共建开发样例》，首先提交到SIG（兴趣组）仓，知识体系SIG仓中的提交也是有效贡献。再次感谢您的关注！

新Sample合入需遵循Sample编码规范。

内容简介

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

架构组成

• Basic
  • Container：线性容器ArrayList（eTS）（API8）
  • Screenshot：屏幕截图（eTS）（API9）（Full SDK）
• AppSample
  • Chat：聊天示例应用（eTS）（API8）
  • Shopping：购物示例应用（eTS）（API8）
• Account
  • AppAccountManager：应用帐号管理（eTS）（API8）
  • DistributeAccount：分布式帐号管理（eTS）（API8）
• Communication
  • RPC：RPC连接（eTS）（API8）
  • Wlan：WLAN（eTS）（API8）（Full SDK）
• ability
  • DMS：分布式Demo（eTS）（API8）（Full SDK）
  • JsDistributedMusicPlayer：分布式音乐播放（JS）（API8）（Full SDK）
  • DataAbility：DataAbility的创建与访问（eTS）（API8）
  • ServiceAbility：ServiceAbility的创建与使用（eTS）（API8）
  • StageCallAbility：StageCallAbility的创建与使用（eTS）（API9）（Full SDK）
  • FormAbility：FA模型卡片（eTS）（API8）
  • FormExtAbility：Stage模型卡片（eTS）（API9）
  • FormLauncher：卡片使用方（eTS）（API8）（Full SDK）
  • ServiceExtAbility：StageExtAbility的创建与使用（eTS）（API9）（Full SDK）
  • DistributedGraffiti：分布式涂鸦（eTS）（API8）（Full SDK）
  • MissionManager：系统任务管理（eTS）（API9）（Full SDK）
  • GalleryForm：图库卡片（eTS）（API9）
  • Launcher：仿桌面应用（eTS）（API9）（Full SDK）
• common
  • AirQuality：空气质量（JS）（API8）
  • Clock：时钟（JS）（API8）
  • DistributeCalc：分布式计算器（JS）（API8）（Full SDK）
  • ECG：心率检测（JS）（API8）
  • Notification：通知（eTS）（API8）
  • ResourceManager：资源管理器（eTS）（API8）
  • Runninglock：运行锁（eTS）（API8）
  • Flashlight：手电筒（JS）（API8）
  • JsHelloWorld：你好世界（JS）（API8）
  • PowerManager：系统电源管理（eTS）（API8）（Full SDK）
  • International：国际化（eTS）（API8）（Full SDK）
• data
  • KvStore：分布式数据库（eTS）（API8）（Full SDK）
  • LiteStorage：轻量级存储（eTS）（API8）
  • DDMQuery：结果集与谓词（eTS）（API8）
  • DistributedRdb：分布式关系型数据库（eTS）（API8）（Full SDK）
  • Preferences：首选项（eTS）（API9）
  • DistributedNote：分布式备忘录（eTS）（API9）（Full SDK）
  • DistributedDataGobang：分布式五子棋（eTS）（API9）（Full SDK）
  • DistributedObjectDms：分布式跑马灯（eTS）（API9）（Full SDK）
• device
  • DeviceManager：设备管理（eTS）（API8）（Full SDK）
  • Sensor：传感器（eTS）（API8）
  • Vibrator：振动（eTS）（API8）
  • DeviceUsageStatistics：设备使用信息统计（eTS）（API8）（Full SDK）
  • Browser：浏览器（eTS）（API9）（Full SDK）
  • Screen：屏幕属性（eTS）（API9）（Full SDK）
  • USBManager：USB管理（eTS）（API8）
  • Bluetooth：蓝牙（eTS）（API9）（Full SDK）
  • Location：位置服务（eTS）（API9）
• Graphics
  • JsWebGL：WebGL（JS）（API8）
  • Window：窗口（eTS）（API9）
• media
  • JsAudioPlayer：音频播放和管理（JS）（API8）
  • JsVideo：视频播放（JS）（API8）
  • Recorder：录音机（eTS）（API8）（Full SDK）
  • MultiMedia：相机和媒体库（eTS）（API9）（Full SDK）
  • VideoPlayer：视频播放（eTS）（API9）（Full SDK）
  • JsRecorder：录音机（JS）（API8）
  • Image：图片处理（eTS）（API8）
  • GamePuzzle：拼图（eTS）（API9）
  • Scan：媒体库相机（eTS）（API9）
  • VideoShow：媒体库视频（eTS）（API9）
• DFX
  • JsDotTest：测试打点（JS）（API8）
  • FaultLogger：故障日志获取（eTS）（API8）
  • Logger：日志打印（eTS）（API9）
  • Debug：Debug（eTS）（API9）
• Safety
  • Cipher：加解密（eTS）（API8）
  • AbilityAccessCtrl：访问权限控制（eTS）（API8）（Full SDK）
• Telephony
  • Call：拨打电话（eTS）（API8）
  • Message：短信服务（eTS）（API8）（Full SDK）
  • RadioTech：网络搜索（eTS）（API8）
  • SimManager：SIM卡管理（eTS）（API8）
  • MobileNetwork：蜂窝数据（eTS）（API9）
  • Observer：Observer（eTS）（API9）
  • Contact：Contact（eTS）（API8）
• thread
  • JsWorker：启动一个worker（JS）（API8）
• CompleteApps
  • KikaInput：轻量级输入法（JS）（API9）（Full SDK）
  • FlipClock：翻页时钟（eTS）（API8）（Full SDK）
• EngineeringCapability
  • Npm：npm的使用（eTS）（API9）
• ETSUI
  • Canvas：画布组件（eTS）（API8）
  • CustomComponent：组件化（eTS）（API8）
  • Process：进程信息（eTS）（API9）（Full SDK）
  • BuildCommonView：创建简单视图（eTS）（API8）
  • DefiningPageLayoutAndConnection：页面布局和连接（eTS）（API8）
  • Drag：拖拽事件（eTS）（API8）
  • Component：eTS组件测试Demo（eTS）（API8）
  • ArkUIAnimation：动画（eTS）（API8）
  • MediaQuery：媒体查询（eTS）（API8）
  • XComponent：XComponent（eTS）（API9）
  • MouseEvent：鼠标事件（eTS）（API8）
  • Web：Web（eTS）（API8）
  • Gallery：组件集合（eTS）（API8）
  • BringApp：拉起系统应用（eTS）（API8）
  • Game2048：2048游戏（eTS）（API8）
  • Lottie：Lottie（eTS）（API8）（Full SDK）
  • TransitionAnimation：转场动画（eTS）（API9）
  • PatternLock：图案密码锁组件（eTS）（API9）
  • Search：Search组件（eTS）（API9）
  • QRCode：二维码（eTS）（API9）
  • UpgradePopup：自定义弹窗（eTS）（API9）
• FileManager
  • FileIo：文件管理（eTS）（API8）
• Native
  • NativeAPI：NativeAPI（eTS）（API8）
• Notification
  • CommonEvent：订阅公共事件（eTS）（API8）
  • Emitter：处理进程内事件（eTS）（API8）
  • AlarmClock：后台代理提醒（eTS）（API8）
  • Notification：订阅、发送通知（eTS）（API9）（Full SDK）
• Network
  • Http：数据请求（eTS）（API9）
  • Socket：Socket 连接（eTS）（API8）
  • WebSocket：WebSocket（eTS）（API9）
  • UploadDownload：上传下载（eTS）（API8）
• Preset
  • Clock：简单时钟（eTS）（API9）
  • FlashLight：手电筒（eTS）（API8）（Full SDK）
  • DistributeCalc：分布式计算器（eTS）（API8）（Full SDK）
  • AirQuality：空气质量（eTS）（API9）
  • DistributedMusicPlayer：分布式音乐（eTS）（API9）（Full SDK）
• PackageManagement
  • ZipLib：压缩与解压（eTS）（API8）
• ResourcesSchedule
  • Flybird：小鸟避障游戏（eTS）（API8）
  • BackgroundTaskManager：后台任务管理（eTS）（API8）
• UI
  • AtomicLayout：原子布局（JS）（API8）
  • Badge：事件标记控件（JS）（API8）
  • International：国际化（JS）（API8）
  • JsFA：FA示例应用（JS）（API8）
  • JsShopping：购物示例应用（JS）（API8）
  • JSMenu：菜单（JS）（API8）
  • JSUICustomComponent：自定义组件（JS）（API8）
  • JsAnimation：动效示例应用（JS）（API8）
  • JsAnimationStyle：动画与自定义字体（JS）（API8）
  • JsBasicComponents：基础组件（JS）（API8）
  • JsBrightness：设置屏幕亮度（JS）（API8）
  • JsCanvas：画布组件（JS）（API8）
  • JsDevice：设备信息（JS）（API8）
  • JsDialog：页面弹窗（JS）（API8）
  • JsGrid：栅格布局（JS）（API8）
  • JsList：商品列表（JS）（API8）
  • JsPanel：内容展示面板（JS）（API8）
  • JsRouter：页面路由（JS）（API8）
  • JsSvg：可缩放矢量图形（JS）（API8）
  • JsTimer：定时器与系统时间设置（JS）（API8）
  • Picker：滑动选择器（JS）（API8）
  • Popup：气泡（JS）（API8）
  • RefreshContainer：下拉刷新容器（JS）（API8）
  • Slider：滑动条（JS）（API8）
  • Stack：堆叠容器（JS）（API8）
  • StepNavigator：步骤导航器（JS）（API8）
  • Swiper：内容滑动容器（JS）（API8）
  • Tabs：页签容器（JS）（API8）
  • Toolbar：工具栏（JS）（API8）
  • chart：图表组件（JS）（API8）
  • JsAdaptivePortalList：多设备自适应的效率型首页（JS）（API8）
  • JsAdaptivePortalPage：多设备自适应的FA页面（JS）（API8）
  • JsImage：基本动画（JS）（API8）
  • JsGallery：图库示例应用（JS）（API8）
  • JSComponments：Js组件（JS）（API8）
  • JsUserRegistration：用户注册（JS）（API8）
  • JsAdaptiveServiceWidget：多设备自适应服务卡片（JS）（API8）
  • JsAnimator：动画（JS）（API8）
• Util
  • UtilBase64Codec：Base64编解码（eTS）（API8）
  • UtilScope：范围判断（eTS）（API8）
  • UtilStringCodec：字符串编解码（eTS）（API8）
  • UtilLruBuffer：缓冲区（eTS）（API8）
  • UtilRationalNumber：有理数（eTS）（API8）
  • UtilTypeCheck：内置对象类型检查（eTS）（API8）
  • UtilUrlString：URL字符串解析（eTS）（API8）
  • XmlTextConvert：xml文本转换（eTS）（API8）
• MultiDeviceAppDev
  • AdaptiveCapabilities：多设备自适应能力（eTS）（API9）
  • JsAdaptiveCapabilities：多设备自适应能力（JS）（API8）

目录

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

app_samples
|---ability                # 页面能力
|---Account                # 账号管理
|---AppSample              # 示例应用
|---Basic                  # 基础组件
|---common                 # 公共能力
|---Communication          # 通信与连接
|---CompleteApps           # 完整应用
|---data                   # 数据管理
|---device                 # 设备管理
|---DFX                    # 日志打印
|---EngineeringCapability  # 工程能力
|---ETSUI                  # eTS UI能力
|---FileManager            # 文件管理
|---Graphics               # 图像绘制
|---media                  # 媒体
|---MultiDeviceAppDev      # 一多应用
|---Native                 # 调用C++能力
|---Network                # 网络连接
|---Notification           # 消息通知
|---PackageManagement      # 包管理
|---Preset                 # 预设应用
|---ResourcesSchedule      # 资源调度
|---Safety                 # 安全
|---Share                  # 分享
|---Telephony              # 电话功能
|---thread                 # 线程操作
|---UI                     # Js UI能力
|---Util                   # 基础工具类

约束

1. 安装应用示例之前，请先查看"README_zh.md"文件来确认应用示例是否为stage模型，若为Stage模型需要查看entry/src/main路径下的module.json5文件中的"deviceType"字段来确认该应用支持的设备类型；否则为FA模型，查看entry/src/main路径下的config.json文件中的"deviceType"字段来确认该应用示例支持的设备类型，两种模型都可尝试通过修改该字段使其可以在相应类型的设备上运行。
2. 应用示例仅支持SDK8版本：3.1.7.5 ，SDK9版本：3.2.5.5 。
3. 应用示例需要使用DevEco Studio 3.0 Beta4 (Build Version: 3.0.0.992, built on July 14, 2022)才可编译运行。

使用方法

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

Changlog

应用修改记录：changelog

相关仓

1. app_sample 已废弃
2. applications_app_sample