docs: 将 notifyDimensionsChange 文档移至全局 API 章节

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: mackwang112

.agents/skills/mpx2rn/references/rn-script-reference.md

@@ -587,11 +587,13 @@ setAppHide()
 | `getCurrentPages()` | 返回当前导航栈中已映射的页面实例列表（顺序与路由 state 相关）。 |
 | `setAppShow()` | 手动触发应用「进入前台」逻辑，驱动已注册的 `onShow`。 |
 | `setAppHide()` | 手动触发应用「进入后台」逻辑，驱动已注册的 `onHide`。 |
+| `notifyDimensionsChange(dimensions?)` | 主动通知框架 dimensions 发生变化，触发 rpx、vw、vh、媒体查询、onResize 等的重新计算。在某些容器环境下（如折叠屏、分屏）系统 `Dimensions` 事件无法正常触发时使用。不传参时默认使用当前全局 dimensions 并重新执行 `customDimensions`。 |
 
 #### 注意事项
 
 - 勿在 App 构造函数执行完成前依赖 `getApp()` 内业务字段已赋值完毕；与路由相关的初始化宜放在 `onLaunch` / `onShow`。
 - `getCurrentPages()` 依赖 React Navigation 焦点与 `__mpxPagesMap`，与原生小程序栈细节不完全相同。
+- `notifyDimensionsChange` 由框架在首次样式计算时自动注入，可在业务代码任意位置调用。
 
 ---
 

docs-vitepress/guide/rn/application-api.md

@@ -463,44 +463,6 @@ createComponent({
 
 例如: 在折叠屏中我们期望只在其中一半屏上展示，可在 customDimensions 中判断当前是否为折叠屏展开状态，如果是则将 ScreenWidth 设置为原来的一半。
 
-#### notifyDimensionsChange
-
-```ts
-(dimensions?: { window: ScaledSize; screen: ScaledSize }) => void
-```
-
-主动通知框架 dimensions 发生变化，触发 rpx、vw、vh、媒体查询、onResize 等的重新计算。
-
-框架默认已监听 `Dimensions.addEventListener('change', ...)` 自动处理尺寸变化。在某些容器环境下（如折叠屏、分屏）系统事件无法正常触发时，可手动调用此方法驱动更新。不传参时默认使用当前全局 dimensions。
-
-**传入 dimensions（系统事件无法触发时）：**
-
-```javascript
-// 示例：折叠屏展开/折叠时手动通知框架
-import { Dimensions } from 'react-native'
-
-foldableScreen.on('change', () => {
-  notifyDimensionsChange({
-    window: Dimensions.get('window'),
-    screen: Dimensions.get('screen')
-  })
-})
-```
-
-**不传参（`customDimensions` 逻辑变更后重新应用）：**
-
-`customDimensions` 是在 dimensions 变化时被调用的转换函数，如果运行时动态修改了 `customDimensions` 的逻辑，需要用无参调用让框架以当前屏幕尺寸重新执行一次 `customDimensions`，使新逻辑立即生效。
-
-```javascript
-// 示例：切换折叠屏展示模式后，重新应用 customDimensions
-mpx.config.rnConfig.customDimensions = ({ window, screen }) => {
-  // 更新后的转换逻辑
-  return isFolded ? { window, screen } : { window, screen: { ...screen, width: screen.width / 2 } }
-}
-// 不传参，用当前屏幕尺寸重新触发 customDimensions
-notifyDimensionsChange()
-```
-
 ### 前后台切换 {#app-state-change}
 
 #### mpx.config.rnConfig.disableAppStateListener