组件使用指导

组件参考文档逐条说明属性、方法和事件；使用指导讲怎么用：工作原理、从零搭起来的完整案例和常见问题。

用户界面

图片轮播（ImageCarousel）：图片轮播：横向滑动切换多张图片，可自动播放、循环播放、显示圆点指示器
布局列表框（LayoutListView）：布局当行模板做卡片列表、网格、聊天列表，含中国大学排名及特色完整工程
布局列表框循序渐进：从商品清单到购物车和网络分页：九关实战：列表、详情、搜索、收藏、购物车、网格、聊天、嵌套首页和网络分页
列表选择器（ListPicker）：列表选择框的基本用法示例
导航条（Navigator）：底部/顶部导航栏、悬浮菜单与多页面切换的完整案例
单选框（RadioGroup）：单选框：一组互斥的单选按钮，一次只能选一项，适合问卷、表单、设置页
底部提示条（Snackbar）：底部提示条：在屏幕底部弹出一条提示，可带一个按钮（如「撤销」「重试」），几秒后自动收起

界面高级

应用工具（AppTools）：引导好评、打开其它 App、去设置开权限、复制粘贴、识别口令、添加桌面快捷方式、首次启动引导的完整案例
自动完成（AutoComplete）：城市输入、搜索历史、省市联动、联网搜索建议的完整案例
组件动画（ComponentAnimation）：22 种动画效果、连续播放与组合动画的完整案例
组件美化（ComponentEnhance）：组件美化工具：添加圆角、边框、渐变背景、卡片样式、字体和行间距；还可为标签、图像、布局等组件注册和取消点击事件，按钮等组件原有的点击事件仍会触发
设备信息（DeviceInfo）：电量、网络、系统版本等设备信息的完整案例
动态组件（DynamicComponents）：动态组件：运行时按名字创建任意组件（按钮、标签、布局……也可以创建拓展组件），设置属性、调用方法、删除、调整顺序，或用 JSON 模板一次创建一批
悬浮窗（FloatingWindow）：一个组件既能显示圆形悬浮球，也能显示布局悬浮窗口；阴影开关与独立水平、垂直间距
虚拟摇杆（Joystick）：虚拟摇杆：手指拖动圆形摇杆，输出 -1 到 1 的 x、y 和上/下/左/右（可选 8 方向）
本地通知（LocalNotification）：定时提醒、带按钮与稍后提醒、进度通知、大图通知、点通知跳转、媒体通知的完整案例
滑动菜单（PopupPanel）：滑动菜单：把一个布局从屏幕底部滑出显示、居中弹出当对话框，或从左右两侧滑出当侧边抽屉（侧滑菜单），面板里可以放任意组件
隐私政策（PrivacyPolicy）：隐私政策与隐私确认弹窗组件
二维码生成（QRCodeGenerator）：网址、名片、WiFi 连接二维码与彩色二维码的完整案例
评分条（RatingBar）：评分条：一排星星，用户点击或拖动打分，也可设为只读用来显示平均分（支持半星）
屏幕控制（ScreenControl）：常亮、系统栏配色、沉浸式状态栏与全屏、截图分享的完整案例
设置页（SettingsList）：用表格制作常用设置页，自动保存、统一事件和动态配置
开屏动画（StartupAd）：开屏广告图、倒计时与跳过的快速上手和使用建议
下拉刷新（SwipeRefresh）：下拉刷新：给列表、垂直滚动条布局、布局列表框、网页等可滚动组件加上下拉刷新手势

界面布局

滚动控制（ScrollHandler）：滚动控制：读取和控制垂直/水平滚动条布局的滚动位置，如聊天记录加一条后自动滚到底部；注册布局后，滚动、到达开头或末尾时触发事件
滑动分页（SwipePager）：标签页、角标、引导页、分类页与导航条联动的完整案例

多媒体

图片处理（ImageTools）：上传前压缩、圆形头像、加水印、转 Base64 识图、多步串联的完整案例
媒体信息（MediaInfo）：媒体信息：读取音频、视频文件的歌名、歌手、专辑、时长、视频尺寸和专辑封面（存成图片文件）
多图选择器（MultiImagePicker）：九宫格发帖、逐张上传、选图做头像与图片保留规则的完整案例
实时预览录制（VideoRecorder）：实时预览录制，有两种模式

绘画动画

多点触控（MultiTouch）：多点触控：同时追踪最多 10 个触摸点（按下、移动、松开，带触摸点序号和坐标），并识别滑动、双击、长按、双指缩放、双指旋转

传感器

生物识别（Biometric）：生物识别：弹出系统的指纹或人脸验证框，确认是本机主人在操作，常用于登录、查看隐私内容、支付确认前的二次验证
计时器（Clock）：倒计时、定时与定点执行、多个定时任务、时间格式化的常见问答
手电筒（FlashLight）：开关按钮、SOS 闪烁、光线暗时自动开灯的完整案例
定时任务（ScheduledTask）：定时任务：到指定时刻（一次、每天、每周几、每隔几分钟）触发「到点」事件；App 不在前台时可弹通知提醒，点通知或下次打开 App 时补发事件

社交应用

日历日程（CalendarEvents）：日历日程：往手机系统日历添加日程（可设提前几分钟提醒）、查询某段时间的日程、删除日程；或打开系统日历的新建日程界面由用户确认保存（不需要权限）
外部打开（ExternalOpen）：外部打开：让 App 出现在系统分享菜单里，接收别的 App 分享来的文字和图片；设置链接前缀后，点击前缀://… 形式的链接会直接打开本 App 并带上参数

数据存储

加密签名（Crypto）：密码摘要、接口签名、AES 加密保存、Basic 认证、与服务器互通的完整案例
文件增强（FileTools）：文件增强工具：复制、移动、删除、重命名文件，列出目录内容，查询容量与路径等
SQLite 数据库（SQLite）：SQLite 数据库组件：兼容主流 SQL 语法的迷你本地数据库引擎，支持事务
WPS在线表格（WpsSheet）：WPS在线表格：通过金山文档的脚本令牌读写在线表格（国内可用，替代谷歌表格）

通信连接

Activity启动器（ActivityStarter）：查看其他 App 的包名与类名并启动它
应用更新（AppUpdate）：版本文件与发布步骤、内置对话框、自定义界面、强制更新的完整案例
二进制（BinaryTools）：拼帧加校验、解析回复、float 互转、状态位、与网络调试助手联调的完整案例
低功耗蓝牙（BluetoothLowEnergy）：内置版接入步骤、连接收发案例与参数边界
下载器（Downloader）：下载器：下载网上的文件并保存到手机，可同时下载多个，报告下载进度，完成后给出文件路径
MQTT客户端（MqttClient）：内置版接入步骤、连接收发案例与参数边界
串口通信器（Serial）：USB 串口原样收发字节；完整回显诊断、半包缓存、校验与超时案例
Socket客户端（SocketClient）：不可见组件，提供 TCP Socket 客户端连接、文本/二进制/文件收发功能
Web客户端（Web）：下载网络图片、原生表单上传文件与请求头鉴权示例
WebSocket客户端（WebSocket）：WebSocket 客户端：连接 ws:// 或 wss:// 服务器，实时收发文本消息，适合聊天室、实时行情、设备状态推送等需要服务器主动推送的场景