diff --git a/docs/api/README.md b/docs/api/README.md
index 8865bbd2d8589fa054cf703ba6c90e72ee432d6b..2a993744cf4790d17d4a4b815300f3d0b01194e8 100644
--- a/docs/api/README.md
+++ b/docs/api/README.md
@@ -2,15 +2,16 @@
 
 uni-app x项目的uts代码中可以使用很多API。包括：
 
-- uts的api，包括[内置对象](../uts/buildin-object-api/global.md)，以及平台专有对象[UTSAndroid](../uts/utsandroid.md)和[UTSiOS](../uts/utsios.md)
-- 全局api，前面不需要加`uni.`。如`getApp`
-- uni.xxx的内置api。见左侧
-- uniCloud.xxx的内置api [详见](./unicloud/README.md)
-- dom的api [详见](../dom/README.md)
-- vue的api [详见](../vue/README.md)
-- os原生api
+1. uts的api，包括[内置对象](../uts/buildin-object-api/global.md)，以及平台专有对象[UTSAndroid](../uts/utsandroid.md)和[UTSiOS](../uts/utsios.md)
+2. 全局api，前面不需要加`uni.`。如`getApp`
+3. uni.xxx的内置api。见左侧
+4. uniCloud.xxx的内置api [详见](./unicloud/README.md)
+5. dom的api [详见](../dom/README.md)
+6. vue的api [详见](../vue/README.md)
+7. os原生api
 	
-	由于uts可以直接调用Android和iOS的api，所以os和三方sdk的能力都可以在uts中调用。如下：
+## os原生api的使用
+由于uts可以直接调用Android和iOS的api，所以os和三方sdk的能力都可以在uts中调用。如下：
 
 ```vue
 <script>
@@ -39,7 +40,7 @@ uni-app x项目的uts代码中可以使用很多API。包括：
 
 插件市场也有很多做好的uts插件，方便开发者拿来即用。[uts插件](https://ext.dcloud.net.cn/?cat1=8&type=UpdatedDate)
 
-虽然上述页面可以直接调用原生能力，但一般原生能力建议封装为[uni_modules](https://uniapp.dcloud.net.cn/plugin/uni_modules.html)形式的[uts插件](https://uniapp.dcloud.net.cn/plugin/uts-plugin.html)。这样方便共享、方便跨平台。
+虽然上述页面可以直接调用原生Android能力，但正规开发时，原生能力应封装为[uni_modules](https://uniapp.dcloud.net.cn/plugin/uni_modules.html)形式的[uts插件](https://uniapp.dcloud.net.cn/plugin/uts-plugin.html)。这样方便共享、方便跨平台。（iOS在js驱动模式时，uvue页面中不支持调用swift API，需封装为uts插件调用原生API）
 
 uni-app x 中不再支持plus和weex的API。过于plus api中一些常用的api，一部分在uni-app x中进行了替换增补、一部分提供了uts操作原生的示例代码。[详见](ext.md)
 
@@ -70,3 +71,13 @@ function getDeviceModel(): string {
 - kotlin中定义一个常量是val，而uts是const；kotlin的变量定义是var，而uts推荐使用let。
 
 更复杂的例子可以[参考](ext.md#kt2uts)
+
+## 生命周期@liftcycle
+
+生命周期是一种特殊事件，对于应用、页面、组件，uni-app x提供了一批对应的生命周期，比如应用的onLaunch、页面的onLoad、组件的created。
+
+- 应用生命周期：[详见](../collocation/app.md#applifecycle)
+- 页面生命周期：[详见](../page.md#lifecycle)
+- 组件生命周期：[详见](../vue/component.md#component-lifecycle)
+
+除了生命周期，uni还提供了一批其他on/off事件监听API，比如uni.onPushMessage()、uni.offPushMessage()。这些不属于生命周期。
\ No newline at end of file
diff --git a/docs/collocation/app.md b/docs/collocation/app.md
index 7325aa0112a8dd8384c73f3e8412a5f0e279fc6f..52137e8f3a03bcbe42bc813f84e7b15427495c37 100644
--- a/docs/collocation/app.md
+++ b/docs/collocation/app.md
@@ -8,6 +8,8 @@
 
 应用生命周期仅可在`App.uvue`中监听，在页面监听无效。
 
+目前`App.uvue`仅支持选项式，暂不支持组合式写法。
+
 ## 应用生命周期@applifecycle
 
 `uni-app-x` 支持如下应用生命周期函数：
diff --git a/docs/page.md b/docs/page.md
index 458c695c8334508f2f06ef6ade05d000c1dac451..e55c2e925a309f9517b4b3d61e407f4a3c584a6a 100644
--- a/docs/page.md
+++ b/docs/page.md
@@ -156,11 +156,22 @@ export default {
 - OnLoadOptions类型目前在web和Android的运行时类型不统一，web是对象，Android是map。[详见issues](https://issues.dcloud.net.cn/pages/issues/detail?id=967)
   - 但仍然可以通过上述示例代码跨平台的获取入参。
   - 后续版本会统一类型为UTSJSONObject。
+- App-iOS平台的窗体动画是异步的，onLoad时可能窗体动画已经开始，此时再设置页面的pageStyle（比如设置背景色），会出现闪烁现象。
 :::
 
+### 页面onShow生命周期@onshow
+onShow是在onLoad之后，它的意义在于，onLoad是页面创建时触发一次；而当页面隐藏（比如被新窗体遮挡），然后页面再恢复显示时，onLoad不会再触发，只会触发onShow。
+
+tabbar页面切换时，老的tabbar页面会hide，新的tabbar页面会show。
+
+onShow和onHide是成对出现的。
+
+在组合式API中，组件可以监听应用和页面的生命周期。但由于应用和页面都有onShow和onHide，导致重名。所以在组合式的组件中监听页面的显示隐藏，改为了onPageShow和onPageHide。
 
 ## 页面及组件生命周期流程图 @lifecycleflow
 
+下图展示了一个新页面，从创建开始，包括其中的组件，完整的时序。
+
 ![](./static/uni-app-lifecycle-vue3.png)#{.zooming width=1000 margin=auto}