# 蓝河文档馆

> 蓝河文档馆是 BlueOS（蓝河操作系统）中文开发文档。面向 Web / Vue 开发者，涵盖教程、UI 组件、JS API、Native API、表盘与快捷卡片。

- 站点：https://blueos.niceshare.site/
- 完整文档（适合整库摄入）：https://blueos.niceshare.site/llms-full.txt
- 单页 Markdown：任意文档 URL 将末尾改为 `.md`，例如 https://blueos.niceshare.site/guide/hello-world.md
- 源码：https://github.com/nicejade/blueos-dev-docs

## 什么是蓝河 / BlueOS

蓝河是 vivo 面向智能手表等穿戴设备的操作系统，英文名为 BlueOS。应用使用 `.ux` 文件（script / template / style）和 `manifest.json` 开发。语法像 Vue，运行时不是 Vue，也不是浏览器 DOM。

## 引用说明

引用本站时请写明「蓝河文档馆」并附上具体页面 URL。权威来源以 Vivo 官方文档为准。

## 教程

- [从这里开始](https://blueos.niceshare.site/guide/): 面向 Web / Vue 开发者的 BlueOS 学习路径：先跑通 Hello World，再做出一个多页面待办应用。
- [数据、列表与事件](https://blueos.niceshare.site/guide/data-list-events/): 在 data 里声明响应式字段，用 for / if 渲染，用 onclick 处理点击。
- [环境与 Hello World](https://blueos.niceshare.site/guide/hello-world/): 安装 BlueOS Studio，新建工程，在模拟器里显示 Hello World。
- [布局与样式](https://blueos.niceshare.site/guide/layout-and-style/): BlueOS 只用 flex 布局，CSS 是 Web 子集。优先 Tailwind utilities。
- [接下来去哪](https://blueos.niceshare.site/guide/next-steps/): 做完第一个蓝河应用之后，按任务进入组件、API、卡片、表盘和性能文档。
- [这不是浏览器，也不是 Vue](https://blueos.niceshare.site/guide/not-vue/): BlueOS 模板长得像 Vue，运行时不是 Vue，也不是浏览器。用对照表避开常见坑。
- [常见问题](https://blueos.niceshare.site/guide/pitfalls/): BlueOS 常见问题，以及黑屏、不更新、不显示等开发排错对照表。
- [做一个待办应用](https://blueos.niceshare.site/guide/todo-app/): 用列表页、详情页、本地存储和一次网络请求，串起一个完整的蓝河小应用。
- [.ux 与 manifest](https://blueos.niceshare.site/guide/ux-and-manifest/): 蓝河的一页由 script、template、style 组成；新页面和系统 API 要写进 manifest.json。

## 参考文档

- [数据绑定](https://blueos.niceshare.site/reference/app-service/data-binding/): 蓝河应用提供了数据绑定 UI 组件的方式，当数据发生变化时，会自动触发 UI 组件的更新。
- [概述](https://blueos.niceshare.site/reference/app-service/event-on/): 通过在 UI 组件上绑定事件，开发者可以实现蓝河应用与用户之间的交互。
- [列表渲染](https://blueos.niceshare.site/reference/app-service/for/): 使用 `for` 指令可循环渲染数组数据。其语法支持多种形式（`{{}}` 可省略）：
- [条件渲染](https://blueos.niceshare.site/reference/app-service/if-show/): 条件渲染有 2 种：if/elif/else 和 show。它们的区别在于：if 为 false 时，组件会从 DOM 中移除，而 show 仅仅是渲染时不可见，组件依然存在于 DOM 中;
- [页面布局](https://blueos.niceshare.site/reference/app-service/page-style-and-layout/): 蓝河应用使用的是 Flex 布局方式。
- [自定义组件](https://blueos.niceshare.site/reference/app-service/parent-child-component-communication/): 熟悉自定义组件的开发，了解父子组件之间的通信方式，如：props，data。
- [props](https://blueos.niceshare.site/reference/app-service/props/): Prop 属性名称使用 camelCase(驼峰命名法)命名法，在外部传递数据时请转化为以 kebab-case (短横线分隔命名) propObject 转换为 prop-object。
- [页面路由](https://blueos.niceshare.site/reference/app-service/switching-pages/): 了解如何打开页面、回退，并传递参数
- [文件组织](https://blueos.niceshare.site/reference/configuration/file-organization/): 本文对项目的文件目录及相关内容进行了介绍，包括蓝河应用文件结构讲解，配置信息、新增页面等
- [框架简介](https://blueos.niceshare.site/reference/configuration/intro/): 蓝河应用框架采用了类 web 开发范式，具有学习成本低，开发效率高的特点。框架提供了丰富的 UI 组件与样式，开发者可以因此高效搭建界面。同时框架提供了两套 API 接口，开发者可以按需选择。
- [manifest 文件](https://blueos.niceshare.site/reference/configuration/manifest/): manifest.json 文件中包含了应用描述、接口声明、页面路由信息
- [javascript 代码](https://blueos.niceshare.site/reference/configuration/script/): 用来定义页面数据和实现生命周期接口
- [style 样式](https://blueos.niceshare.site/reference/configuration/style-sheet/): 用于描述 template 模板的组件样式，决定组件应该如何显示
- [UX 文件](https://blueos.niceshare.site/reference/configuration/ux-file/): APP、页面和自定义组件均通过 ux 后缀文件编写，ux 后缀文件由 [javascript 代码](/reference/configuration/script)、template 模板和[style 样式](/reference/configuration/style-sheet) 3 个部分组成，一个典型的页面
- [页面启动模式](https://blueos.niceshare.site/reference/extend/launch-mode/): 页面启动模式 — 蓝河文档馆 BlueOS 开发文档
- [屏幕适配](https://blueos.niceshare.site/reference/extend/mulit/): 蓝河操作系统支持对不同尺寸和不同形状的屏幕的适配能力。
- [后台运行](https://blueos.niceshare.site/reference/extend/resident/): 为了节省系统资源，通常情况下，应用切换到后台后将会暂停运行，等到再次切换回前台时继续运行。但音乐/运动等类型的应用， 退到后台后可能仍然需要继续运行，为满足此类需求，加入了对后台运行的支持。
- [表盘](https://blueos.niceshare.site/reference/extend/watchface/): 表盘指默认开机首屏的界面，可分为指针表盘和数字表盘，除了查看时间，表盘还可以给用户提供展示计步、心率、电量、天气等关键信息。
- [快捷卡片](https://blueos.niceshare.site/reference/extend/widget/): ⚠ 快捷卡片已经弃用，请使用 [智慧服务卡片](/reference/widget/overview)
- [概述](https://blueos.niceshare.site/reference/perf-guide/overview/): 本章节聚焦手表应用的性能优化，结合可穿戴设备资源受限、低功耗需求和小屏幕交互特点，提出切实可行的优化策略。我们将重点关注电池续航、显示功耗和交互流畅度，帮助开发者在蓝河应用框架下构建高效、稳定的智能穿戴产品。
- [避免高耗性能操作](https://blueos.niceshare.site/reference/perf-guide/perf-dangerous/): 在蓝河应用开发中，需特别注意以下高消耗性能操作，合理规避可显著提升渲染效率与运行时性能。
- [响应式数据优化](https://blueos.niceshare.site/reference/perf-guide/perf-data/): 蓝河框架基于 Proxy 实现响应式追踪机制，data 对象中的每个属性都会创建监听代理。优化数据层可显著降低内存消耗，提升渲染速度。
- [帧率优化指引](https://blueos.niceshare.site/reference/perf-guide/perf-frame-rate/): 本节介绍提升帧率的有效方法。
- [减少初始化开销](https://blueos.niceshare.site/reference/perf-guide/perf-init/): 应用初始化阶段的代码复杂度直接影响应用/页面实例的创建耗时，优化该阶段的执行效率能显著改善首屏渲染性能。
- [长列表性能优化](https://blueos.niceshare.site/reference/perf-guide/perf-longlist/): 本文阐述了长列表场景下的性能优化方案，在开发过程中遇到长列表性能问题时，可参考下面优化方案。
- [js 内存泄漏排查](https://blueos.niceshare.site/reference/perf-guide/perf-memory-leak/): 在需要排查的场景先后进行两次 dump, 比如排查页面泄漏，在进入页面前 dump 一次，进入页面退出后再 dump 一次
- [运行时性能优化](https://blueos.niceshare.site/reference/perf-guide/perf-runtime/): 本节提供的关键优化手段可显著提升页面渲染与更新效率。
- [图片资源优化](https://blueos.niceshare.site/reference/perf-guide/perf-src/): 本章为 UI 设计师提供界面资源设计规范，通过科学管理图片资源降低内存占用、提升渲染性能、优化安装包体积，适用于设计阶段至开发交付全流程。
- [退出页面释放监听](https://blueos.niceshare.site/reference/perf-guide/perf-subscription/): 在蓝河应用开发中，正确处理页面生命周期末端的资源释放是保障应用性能的关键。以下规范针对页面销毁阶段（onDestroy）必须执行的三类资源清理操作。
- [减少代码体积](https://blueos.niceshare.site/reference/perf-guide/perf-treeshaking/): 本节非常重要，优劣不同的写法会有明显的代码体积差异，而代码体积越小，会获得更快的加载速度。
- [编译环境变量](https://blueos.niceshare.site/reference/question-answer/build-env/): 编译环境变量 `process.env.NODE_ENV` 用于在构建时判断生产环境或开发环境。它可以帮助在编译时去掉不必要构建的代码块。环境变量的一种使用场景是用于模拟器无法覆盖的能力，可以使用 JavaScript 来模拟这些情况。
- [国际化](https://blueos.niceshare.site/reference/question-answer/i18n/): 蓝河应用平台的能力会覆盖多个国家地区，平台支持国际化(i18n)的能力后，可以做到让一个蓝河应用产品（一个 RPK 文件）同时支持多个语言版本的切换，开发者无需开发多个不同语言的源码项目，避免给项目维护带来困难。
- [概述](https://blueos.niceshare.site/reference/quickstart/introduction/): 蓝河应用开发采用类 web 开发范式，使用 UI 组件来搭建页面布局，使用样式来描述组件和页面的效果，使用 Javascript 来进行业务逻辑的开发。蓝河应用支持 MVVM（Model-View-ViewModel）的架构，通过数据绑定视图的方式，数据发生变化时，会自动触发 UI 的更新。
- [构建首个蓝河应用](https://blueos.niceshare.site/reference/quickstart/quick-start/): 本文将从开发工具、新建项目、安装依赖、调试项目、打包等方面入手，让您学习后，可以构建首个蓝河应用。
- [标准卡开发](https://blueos.niceshare.site/reference/widget/js-widget/): 标准卡和普通蓝河页面开发范式相同，包含下列常见能力：
- [轻卡开发](https://blueos.niceshare.site/reference/widget/lite-widget/): 轻卡不运行 JavaScript，因此其开发范式与标准卡片存在差异，具体细节将在本节中进一步介绍。
- [概述](https://blueos.niceshare.site/reference/widget/overview/): 本节介绍卡片的定义、分类、模块架构和运行原理。
- [卡片配置](https://blueos.niceshare.site/reference/widget/project-config/): 本节介绍卡片配置及工程目录，通过示例展示了轻卡和标准卡的具体配置方法。
- [widgetProvider 开发](https://blueos.niceshare.site/reference/widget/widget-provider/): 本节将介绍 widgetProvider 的核心概念和三种实现方式。鉴于不同平台的开发方式各有差异，开发者可以做在具体文档中查阅。本节重点讲解 widgetProvider 的顶层概念，通过理解这些概念，您将更容易掌握不同实现方式之间的互通性。

## UI 组件

- [a](https://blueos.niceshare.site/component/basic/a/): 超链接（默认不带下划线）。文本内容写在标签内容区，支持转义字符`"\"`
- [animated-vector](https://blueos.niceshare.site/component/basic/animated-vector/): animated-vector 组件，用于解析渲染安卓 xml 动画资源。
- [概述](https://blueos.niceshare.site/component/basic/animation-overview/): 提供用于实现页面元素动画效果的 UI 组件，通常用于增强用户交互体验，吸引用户的注意力，提高页面的美观度和可视化效果。
- [arc-text](https://blueos.niceshare.site/component/basic/arc-text/): 弧形文本，文本内容展示在 arc-text 组件盒模型内最大且居中的圆周上，超出的内容将会被截断。
- [barcode](https://blueos.niceshare.site/component/basic/barcode/): 条形码，将文本内容转换为条形码展示。
- [image](https://blueos.niceshare.site/component/basic/image/): 渲染图片，不支持子组件、事件、方法
- [image-animator](https://blueos.niceshare.site/component/basic/image-animator/): image-animator — 蓝河文档馆 BlueOS 开发文档
- [marquee](https://blueos.niceshare.site/component/basic/marquee/): 跑马灯组件，用于展示一段滚动文字，默认为单行显示。
- [概述](https://blueos.niceshare.site/component/basic/overview/): 作为组成复杂组件和应用的基础模块，基本的 UI 展示功能通常包括文本框、链接和图片等元素。这些 UI 组件是构建用户界面的重要基础，通过这些基本元素的组合与拼接，可以实现丰富多彩、充满个性化的 UI 设计。蓝河系统提供了这些基本 UI 展示功能的实现和支持，以帮助您快速构建和部署丰富多样的用户界面和互动性应用。
- [physics-engine](https://blueos.niceshare.site/component/basic/physics-space/): 物理引擎是一种用于模拟现实世界物理规律的能力，包括重力、碰撞、摩擦、弹性、刚体运动等，使应用中的物体行为更加自然、真实。
- [progress](https://blueos.niceshare.site/component/basic/progress/): 进度条，不支持子组件，支持[通用事件](/component/common/common-events)
- [qrcode](https://blueos.niceshare.site/component/basic/qrcode/): 二维码，将文本内容转换为二维码展示。
- [span](https://blueos.niceshare.site/component/basic/span/): 格式化的文本，只能作为[<text>](/component/basic/text)子组件，不支持事件，目前不支持换行。
- [svg-container](https://blueos.niceshare.site/component/basic/svg-container/): 渲染 svg 图片，可以动态修改 svg 属性
- [text](https://blueos.niceshare.site/component/basic/text/): 文本，文本内容写在标签内容区
- [动画样式](https://blueos.niceshare.site/component/common/animation-styles/): 蓝河应用支持开发者制作动画，提供了`transform`类、`animation`类的动画样式属性，且参数格式与 CSS 对齐，更方便开发者上手适配动画
- [颜色样式](https://blueos.niceshare.site/component/common/color/): 蓝河应用支持[颜色值类型](/component/common/common-styles)
- [通用属性](https://blueos.niceshare.site/component/common/common-attributes/): 通用属性，即所有组件都支持的属性。
- [通用事件](https://blueos.niceshare.site/component/common/common-events/): 通用事件指所有组件均支持的事件回调。
- [通用方法](https://blueos.niceshare.site/component/common/common-methods/): 通用方法，提供给所有组件调用的方法
- [通用样式](https://blueos.niceshare.site/component/common/common-styles/): 通用样式，即所有组件都可以支持的样式
- [组件动画](https://blueos.niceshare.site/component/common/component-animation/): 除了提供常规的 CSS 样式动画，蓝河应用还具备 JS 组件动画的方法。相比于 CSS 样式动画，这种动画方式拥有更为灵活、个性化的逻辑控制能力。
- [自定义字体样式](https://blueos.niceshare.site/component/common/font-face-style/): font-face 用于定义字体样式。当需要为文本组件设置自定义字体时，可以在 style 中定义 font-face 作为自定义字体，然后在 font-family 中可以引用该字体。
- [渐变样式](https://blueos.niceshare.site/component/common/gradient-styles/): 渐变 (gradients) 可以在两个或多个指定的颜色之间显示平稳的过渡，用法与 CSS 渐变一致。
- [概述](https://blueos.niceshare.site/component/common/rule/): UI 组件是编写整个界面的基础。蓝河系统的组件拥有多项核心能力，包括属性、样式、事件和方法，同时还支持表冠旋转相关的事件处理和复杂动画，让您的界面更加生动有趣。
- [UI 组件支持的表冠旋转](https://blueos.niceshare.site/component/common/ui-rotation/): 作为手表上非常重要的交互按钮，表冠在蓝河系统中得到了充分的支持。我们严格遵守了只有在获得表冠焦点后才能响应表冠事件的规则，在此前提下，蓝河系统提供了丰富的表冠响应方式，并支持开发者进行自定义和个性化的表冠响应。这些支持和机制的存在，可以让开发人员更加便捷地使用 UI 组件和表冠交互控制，提高表冠的交互性和可用性。
- [div](https://blueos.niceshare.site/component/container/div/): 基本容器，支持子组件，支持[通用属性](/component/common/common-attributes)，支持[通用样式](/component/common/common-styles)，支持[通用事件](/component/common/common-events)
- [list](https://blueos.niceshare.site/component/container/list/): 列表视图容器，仅支持[`<list-item>`](/component/container/list-item)子组件，支持[通用属性](/component/common/common-attributes)，支持[通用样式](/component/common/common-styles)
- [list-item](https://blueos.niceshare.site/component/container/list-item/): [`<list>`](/component/container/list)的子组件，用来展示列表具体 item，宽度默认充满 list 组件，支持子组件，支持[通用属性](/component/common/common-attributes)，支持[<div>样式](/0f4779940f452650bf63aba1
- [概述](https://blueos.niceshare.site/component/container/overview/): 布局/容器组件是实现 UI 布局的核心模块之一，不仅可以提供独立的布局功能，还可以多个容器组合，实现更为复杂的布局模式和视觉效果。布局容器还能够为其它 UI 组件提供适当的间距及排列方式，使得整个页面更加美观，构建更丰富的 UI 界面。
- [scroll](https://blueos.niceshare.site/component/container/scroll/): 滚动视图容器。竖向或水平方向滚动容器，竖向滚动需要设置定高，水平滚动需要设置定宽。
- [stack](https://blueos.niceshare.site/component/container/stack/): 基本容器，子组件排列方式为层叠排列，每个直接子组件按照先后顺序依次堆叠，覆盖前一个子组件，支持子组件，支持[通用属性](/component/common/common-attributes)
- [swiper](https://blueos.niceshare.site/component/container/swiper/): 滑块视图容器，支持子组件
- [cellular-list](https://blueos.niceshare.site/component/extend/cellular-list/): 蜂窝列表组件，将指定结构的数组渲染成蜂窝状列表。
- [drawer](https://blueos.niceshare.site/component/extend/drawer/): 抽屉容器，抽屉默认隐藏。可通过边缘滑动，支持 flex 布局。
- [drawer-navigation](https://blueos.niceshare.site/component/extend/drawer-navigation/): [<drawer>](/component/extend/drawer)的子组件，用来展示具体的抽屉内容
- [概述](https://blueos.niceshare.site/component/extend/overview/): 用于简化页面导航的 UI 组件，通过提供直观的导航形式、清晰的页面路径和视觉创意等，提供了便捷的导航体验
- [概述](https://blueos.niceshare.site/component/global/overview/): 提供基于蓝河应用的特定的设计规范和标准所设计的 UI 组件，这些组件具有统一的设计风格、布局、图标元素和字体字号等，旨在为用户提供全面的业务场景下的界面设计需求。
- [vw-alert](https://blueos.niceshare.site/component/global/vw-alert/): 控件定义：弹窗组件，此组件为应用内主动触发的信息、操作确认弹窗（注意：此组件不包含应用外的系统通知提醒弹窗）
- [vw-button](https://blueos.niceshare.site/component/global/vw-button/): 一种基础的组件，点击后可执行对应（按钮表意）的操作。包含“文字按钮”“图标按钮”两类；
- [vw-empty](https://blueos.niceshare.site/component/global/vw-empty/): 控件定义：页面无用户生成的内容时，显示空白页控件元素：
- [vw-icon](https://blueos.niceshare.site/component/global/vw-icon/): 控件定义：提供一套常用图标
- [vw-list](https://blueos.niceshare.site/component/global/vw-list/): 列表包含一系列连续的列表项，可以呈现文本、图标等内容。 list 只提供每个选项相同的列表，如果每个选项不同可使用 list-item 类组件进行实现。
- [vw-list-item](https://blueos.niceshare.site/component/global/vw-list-item/): 列表选项可以作为列表的子项，当列表的每一项不同时可以用列表选项拼接实现。 list-item 代表一类组件，命名上我们用 li 缩写代替 list-item
- [vw-loading](https://blueos.niceshare.site/component/global/vw-loading/): 用于定性地指示一种过程状态，多用于数据加载过程，如加载应用列表，或从网络端获取内容的过程
- [vw-slide](https://blueos.niceshare.site/component/global/vw-slide/): 滑动条组件用来快速调节设置值，如音量、亮度、色彩饱和度等. 用户通过点击左侧/右侧按钮的方式增加/降低数值.
- [vw-title](https://blueos.niceshare.site/component/global/vw-title/): 标题显示在页面顶部，作为关键导航信息，用来告知用户当前在哪里。
- [canvas](https://blueos.niceshare.site/component/others/canvas/): 画布组件，通过使用 JavaScript 中的脚本，可以在 canvas 上绘制图形，文字等。
- [artboard](https://blueos.niceshare.site/component/table/artboard/): 提供可交互的界面，接收用户的笔画输入
- [input](https://blueos.niceshare.site/component/table/input/): 提供可交互的界面，接收用户的输入，默认为单行
- [label](https://blueos.niceshare.site/component/table/label/): 为 [input](/243cfb621699ee56fd958427779e1fcb/input.md) 组件定义标注
- [概述](https://blueos.niceshare.site/component/table/overview/): 用于收集和展示用户的信息，以便后续的处理。可通过搭配使用不同的表单组件，实现不同的业务需求，比如登录、注册和信息填写等
- [picker](https://blueos.niceshare.site/component/table/picker/): 滚动选择器，支持四种选择器，普通选择器，日期选择器，时间选择器，索引栏选择器。
- [slider](https://blueos.niceshare.site/component/table/slider/): slider — 蓝河文档馆 BlueOS 开发文档
- [switch](https://blueos.niceshare.site/component/table/switch/): switch — 蓝河文档馆 BlueOS 开发文档

## JS API

- [自然语言处理](https://blueos.niceshare.site/api/ai/nlp/): 该接口底层依赖以下接口实现，开发者使用前需要在 manifest.json 中声明以下接口:
- [概述](https://blueos.niceshare.site/api/ai/overview/): 基于 [vivo 算法平台](https://developers.vivo.com/product/ai/algorithm)，蓝河 AI 服务为开发者提供了图像、语音、自然语言处理等优质能力。通过这些能力，开发者可以为用户提供更智能的服务及体验。
- [语音技术](https://blueos.niceshare.site/api/ai/speech/): 语音技术目前支持 ASR 与 TTS 两种技术。
- [视觉技术](https://blueos.niceshare.site/api/ai/vision/): 该接口底层依赖以下接口实现，开发者使用前需要在 manifest.json 中声明以下接口:
- [通用错误码](https://blueos.niceshare.site/api/common/error-code/): BlueOS 开发者文档
- [概述](https://blueos.niceshare.site/api/common/overview/): 在本章节中，我们将为您介绍蓝河系统 JS API 的调用规则和通用的错误码。通过阅读本章节，您将了解 JS API 的三种调用形式——同步、异步和订阅，并且掌握一些常见的错误码。
- [调用规则](https://blueos.niceshare.site/api/common/rule/): 同步方法调用后必须等到方法结果返回后才能继续后续的行为，返回值可以是任意类型。
- [说明](https://blueos.niceshare.site/api/connect/brief-introduction/): 针对手机及vivo智能终端设备互联，向第三方应用开发者提供高层次的、简单易用的 API。
- [vivo 智能终端设备 SDK 隐私政策](https://blueos.niceshare.site/api/connect/development-guidance/privacy-policy/): 本隐私政策适用于维沃移动通信有限公司及其关联方（以下简称“我们”或“vivo”，注册地址：广东省东莞市长安镇维沃路 1 号）提供的 vivo 智能终端设备 SDK 产品及服务（以下统称“SDK 产品”）。本文档要向开发者及其终端用户(“终端用户”)说明，为了实现产品的相关功能，本服务将如何处理终端用户的个人信息。
- [vivo 智能终端设备 SDK](https://blueos.niceshare.site/api/connect/development-guidance/rpc-sdk-guidance/): vivo 智能终端设备 SDK — 蓝河文档馆 BlueOS 开发文档
- [穿戴业务 Kit](https://blueos.niceshare.site/api/connect/development-guidance/watch-guidance/): 穿戴业务 Kit — 蓝河文档馆 BlueOS 开发文档
- [vivo 智能终端设备侧](https://blueos.niceshare.site/api/connect/interconnect/): 用于和搭配使用的手机 app 进行通信，收发手机 app 数据。
- [概述](https://blueos.niceshare.site/api/connect/introduce/): 基于开放兼容的 BlueXlink 互联底座，可以实现不同设备间的能力互补，为用户提供一致的交互体验。
- [手机侧](https://blueos.niceshare.site/api/connect/mobile-side/): 手机侧 — 蓝河文档馆 BlueOS 开发文档
- [应用沙箱目录](https://blueos.niceshare.site/api/extend/file-sandbox/): 蓝河应用框架给每个应用分配了一个专属的应用目录，蓝河应用的数据访问和操作都被限制在该目录内，此目录下存放的数据可以保护数据的安全性，这个目录称为 “应用的沙箱目录”。
- [生命周期](https://blueos.niceshare.site/api/extend/lifecycle/): 了解应用/页面/自定义组件的生命周期与状态
- [运动健康](https://blueos.niceshare.site/api/health/health/): 蓝河应用等运动健康模块旨在支持用户的运动和健康数据管理。该模块提供了两个主要部分：采样数据和统计数据，为用户提供了全面的健康数据管理和实时监控功能，对于健康和运动类应用、健康监测工具和健康管理应用非常有用。
- [数据共享](https://blueos.niceshare.site/api/storage/exchange/): 提供了一个不同蓝河应用间数据交互的方式。蓝河应用可以利用它发布数据，或从其他蓝河应用获取数据
- [文件存储](https://blueos.niceshare.site/api/storage/file/): 文件存储 — 蓝河文档馆 BlueOS 开发文档
- [K-V 数据存储](https://blueos.niceshare.site/api/storage/localstorage/): K-V 数据存储 — 蓝河文档馆 BlueOS 开发文档
- [概述](https://blueos.niceshare.site/api/storage/overview/): 蓝河应用的数据存储能力模块使应用能够更好地管理和存储数据，提供了广泛的工具和功能，从简单的键值存储到文件操作，以及跨应用数据共享，提供了多样化数据管理和共享能力。
- [存储空间统计](https://blueos.niceshare.site/api/storage/statvfs/): statvfs 一个用来获取应用空间的模块，包含了获取可用空间与总空间接口，支持同步与异步。
- [应用管理](https://blueos.niceshare.site/api/system/am/): 应用管理 — 蓝河文档馆 BlueOS 开发文档
- [概述](https://blueos.niceshare.site/api/system/app/): 蓝河应用的应用框架为开发者提供了广泛的能力，以构建、管理蓝河应用的各个方面。通过这些能力，开发者可以更好地控制和定制蓝河应用的行为、用户体验以及数据操作。
- [音频](https://blueos.niceshare.site/api/system/audio/): 音频 — 蓝河文档馆 BlueOS 开发文档
- [音频管理](https://blueos.niceshare.site/api/system/audiomanager/): 音频管理 — 蓝河文档馆 BlueOS 开发文档
- [电量信息](https://blueos.niceshare.site/api/system/battery/): 电量信息 — 蓝河文档馆 BlueOS 开发文档
- [蓝牙](https://blueos.niceshare.site/api/system/bluetooth/): 传统蓝牙本机管理：打开和关闭蓝牙、设置和获取本机蓝牙名称、扫描和取消扫描周边蓝牙设备、获取本机蓝牙 profile 对其他设备的连接状态、获取本机蓝牙已配对的蓝牙设备列表。
- [屏幕亮度](https://blueos.niceshare.site/api/system/brightness/): 屏幕亮度 — 蓝河文档馆 BlueOS 开发文档
- [密码算法](https://blueos.niceshare.site/api/system/cipher/): 密码算法 — 蓝河文档馆 BlueOS 开发文档
- [概述](https://blueos.niceshare.site/api/system/communicationoverview/): 蓝河应用通信能力为应用提供了丰富的通信工具，从本地设备到远程服务器，从文件传输到实时通信，从蓝牙到网络状态监测，为应用提供了多样化的数据传输和通信渠道。这使开发者能够构建更多样化的应用，实现应用内外的数据传输和通信。
- [日志打印](https://blueos.niceshare.site/api/system/console/): 日志打印模块用于帮助开发者在应用开发和调试过程中记录和分析信息，有利于错误排查和性能优化。
- [设备信息](https://blueos.niceshare.site/api/system/device/): 设备信息 — 蓝河文档馆 BlueOS 开发文档
- [公共事件](https://blueos.niceshare.site/api/system/event/): 公共事件提供了多应用间数据传递和事件交互的能力。
- [解压缩](https://blueos.niceshare.site/api/system/fastlz/): 解压缩 — 蓝河文档馆 BlueOS 开发文档
- [数据请求](https://blueos.niceshare.site/api/system/fetch/): 数据请求 — 蓝河文档馆 BlueOS 开发文档
- [生成签名证书指纹](https://blueos.niceshare.site/api/system/generatecertificatethumbprint/): 开发者通过**JDK**的**Keytool**工具以及签名文件，导出**SHA256**指纹。
- [地理位置](https://blueos.niceshare.site/api/system/geolocation/): 地理位置 — 蓝河文档馆 BlueOS 开发文档
- [概述](https://blueos.niceshare.site/api/system/hardware/): 蓝河应用的基础硬件能力模块旨在为应用提供访问和控制设备的基础硬件功能。该模块使应用能够与设备硬件进行互动，为开发者提供了强大的工具，以满足应用特定功能要求。
- [输入法](https://blueos.niceshare.site/api/system/inputmethod/): 输入法 — 蓝河文档馆 BlueOS 开发文档
- [多媒体](https://blueos.niceshare.site/api/system/media/): 多媒体 — 蓝河文档馆 BlueOS 开发文档
- [概述](https://blueos.niceshare.site/api/system/multimediaoverview/): 蓝河应用多媒体能力支持音频业务的开发，提供音频相关的功能，主要包括音频播放、音频流式播放、录音、音量管理等。
- [网络状态](https://blueos.niceshare.site/api/system/network/): 网络状态 — 蓝河文档馆 BlueOS 开发文档
- [消息通知](https://blueos.niceshare.site/api/system/notification/): 消息通知 — 蓝河文档馆 BlueOS 开发文档
- [包管理](https://blueos.niceshare.site/api/system/package/): 包管理 — 蓝河文档馆 BlueOS 开发文档
- [页面栈管理](https://blueos.niceshare.site/api/system/pagestack/): 页面栈管理 — 蓝河文档馆 BlueOS 开发文档
- [概述](https://blueos.niceshare.site/api/system/peaceoverview/): 蓝河应用安全模块旨在确保应用程序的数据和用户信息得到有效的保护，以防止未经授权的访问和数据泄漏。
- [权限管理](https://blueos.niceshare.site/api/system/permission/): **说明：** 位置信息
- [概述](https://blueos.niceshare.site/api/system/phoneoverview/): BlueOS 开发者文档
- [弹窗](https://blueos.niceshare.site/api/system/prompt/): 弹窗 — 蓝河文档馆 BlueOS 开发文档
- [录音](https://blueos.niceshare.site/api/system/record/): 录音 — 蓝河文档馆 BlueOS 开发文档
- [上传下载](https://blueos.niceshare.site/api/system/request/): 上传下载 — 蓝河文档馆 BlueOS 开发文档
- [页面路由](https://blueos.niceshare.site/api/system/router/): 页面路由 — 蓝河文档馆 BlueOS 开发文档
- [定时任务](https://blueos.niceshare.site/api/system/schedule/): 定时任务 — 蓝河文档馆 BlueOS 开发文档
- [屏幕管理](https://blueos.niceshare.site/api/system/screen/): 屏幕管理 — 蓝河文档馆 BlueOS 开发文档
- [传感器](https://blueos.niceshare.site/api/system/sensor/): 传感器 — 蓝河文档馆 BlueOS 开发文档
- [系统设置](https://blueos.niceshare.site/api/system/settings/): 系统设置 — 蓝河文档馆 BlueOS 开发文档
- [短信](https://blueos.niceshare.site/api/system/short-message-service/): 在蓝河系统中，我们提供了 Deeplink 链接来使您可以快速打开短信服务所对应的页面。
- [sim 卡管理](https://blueos.niceshare.site/api/system/simmanager/): sim 卡管理 — 蓝河文档馆 BlueOS 开发文档
- [概述](https://blueos.niceshare.site/api/system/softwareoverview/): 蓝河应用的基础软件能力为应用提供了基础的软件功能支持，包括系统设置、输入法、解压缩、解包和序列化等，可以帮助开发者更加高效、快速地进行软件开发和计算机操作
- [应用上下文](https://blueos.niceshare.site/api/system/systemapp/): 应用上下文 — 蓝河文档馆 BlueOS 开发文档
- [解包](https://blueos.niceshare.site/api/system/tar/): 解包 — 蓝河文档馆 BlueOS 开发文档
- [电话](https://blueos.niceshare.site/api/system/telephony-service/): 在蓝河系统中，您可以通过 Deeplink 链接来打开电话服务相应页面。
- [振动](https://blueos.niceshare.site/api/system/vibrator/): 振动 — 蓝河文档馆 BlueOS 开发文档
- [websocket](https://blueos.niceshare.site/api/system/websocket/): websocket — 蓝河文档馆 BlueOS 开发文档
- [widgetManager](https://blueos.niceshare.site/api/system/widget-manager/): widgetProvider 通过 widgetManager 来刷新 卡片 UI 页面中的 uiData 数据，widgetManager 也可以用于主应用刷新 uidata 的数据。
- [widgetProvider](https://blueos.niceshare.site/api/system/widget-provider/): widgetProvider 是轻卡的核心组成部分，它负责执行轻卡页面的逻辑，并与轻卡页面进行数据传递。

## Native API

- [密码算法](https://blueos.niceshare.site/native/cipher/cipher/): 密码算法 — 蓝河文档馆 BlueOS 开发文档
- [设备信息](https://blueos.niceshare.site/native/device/device/): 设备信息 — 蓝河文档馆 BlueOS 开发文档
- [压缩解压](https://blueos.niceshare.site/native/file/compress/): 压缩解压 — 蓝河文档馆 BlueOS 开发文档
- [文件系统](https://blueos.niceshare.site/native/file/filesystem/): 文件系统 — 蓝河文档馆 BlueOS 开发文档
- [地理位置](https://blueos.niceshare.site/native/geolocation/geolocation/): 地理位置 — 蓝河文档馆 BlueOS 开发文档
- [上传下载](https://blueos.niceshare.site/native/network/download/): 上传下载 — 蓝河文档馆 BlueOS 开发文档
- [数据请求](https://blueos.niceshare.site/native/network/fetch/): 数据请求 — 蓝河文档馆 BlueOS 开发文档
- [网络状态](https://blueos.niceshare.site/native/network/network/): 网络状态 — 蓝河文档馆 BlueOS 开发文档
- [包管理](https://blueos.niceshare.site/native/package/package/): 包管理 — 蓝河文档馆 BlueOS 开发文档
- [概述](https://blueos.niceshare.site/native/quickstart/introduction/): 除了 JS API，我们还针对高性能的需求场景提供 Native API。当前，我们开放了部分能力的 Native API，并支持 C、C++标准库及标准 POSIX 接口。
- [标准库支持](https://blueos.niceshare.site/native/stdlibsupport/stdlibsupport/): BlueOS 手表平台当前支持核心能力的标准 POSIX 接口，包含不依赖于内核的库函数实现，保证 Native 开发所需基础能力。