{"_id":"@cordova-ohos/cordova-plugin-screen-orientation","_rev":"5-a1478103c5bea47901b543ff59b4af59","name":"@cordova-ohos/cordova-plugin-screen-orientation","dist-tags":{"latest":"3.0.5"},"versions":{"3.0.4":{"name":"@cordova-ohos/cordova-plugin-screen-orientation","version":"3.0.4","keywords":["cordova","screen-orientation","ecosystem:cordova","cordova-openharmony"],"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-screen-orientation@3.0.4","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"}],"bugs":{"url":"https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-screen-orientation/issues"},"dist":{"shasum":"5dc52fab2d8a4961a7be7eb223f3e80f8a78a87d","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-screen-orientation/-/cordova-plugin-screen-orientation-3.0.4.tgz","fileCount":9,"integrity":"sha512-/eoKpByLovx79toHVCqZnZ+NhbDxA+au1pIJYL0M0e97ozq42LIApYAUaUqyla19zZzH7gd/Quo3T1Jbn9W/wg==","signatures":[{"sig":"MEUCIQDclpicZ7UEjbQfaP8PtvUDLGPLI2n4r3fIwH8nY1x2kgIgWBa4Jq61kR7KqMveVqNvaKq5z8jBWsa6cksMY9mMFBo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38038},"cordova":{"id":"cordova-plugin-screen-orientation","platforms":["ohos"]},"engines":{"cordovaDependencies":{"3.0.4":{"hcordova":">=1.0.0","@cordova-ohos/ohos":">=2.0.0"}}},"gitHead":"21f890c9ca9b9585fa95716299f2ad8264c8eb68","_npmUser":{"name":"luqi_tan","email":"295099422@qq.com"},"repository":{"url":"gitcode:OpenHarmony-Cordova/cordova-plugin-screen-orientation","type":"git"},"_npmVersion":"10.5.1","description":"Cordova Screen Orientation Plugin","directories":{},"_nodeVersion":"22.0.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cordova-plugin-screen-orientation_3.0.4_1773827211880_0.7154979068329244","host":"s3://npm-registry-packages-npm-production"}},"3.0.5":{"name":"@cordova-ohos/cordova-plugin-screen-orientation","version":"3.0.5","description":"Cordova Screen Orientation Plugin","cordova":{"id":"cordova-plugin-screen-orientation","platforms":["ohos"]},"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-screen-orientation"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-screen-orientation/issues"},"keywords":["cordova","screen-orientation","ecosystem:cordova","cordova-openharmony"],"engines":{"cordovaDependencies":{"3.0.5":{"@cordova-ohos/ohos":">=2.0.0","hcordova":">=1.0.0"}}},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-screen-orientation@3.0.5","gitHead":"407498990e18e1cfd97ef8257d49e3b082eff19c","_nodeVersion":"22.0.0","_npmVersion":"10.5.1","dist":{"integrity":"sha512-UpUWxwZ6nNA9X/mGpxO2OE3dRbjrcEPh/WOY3SjJzudo7rxLz7A782nyF9TI4SwDbwNII3tnh9lHy8GWsVQ6QA==","shasum":"577e545a0f59d7b944a64f682f7ea8fea5369fa0","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-screen-orientation/-/cordova-plugin-screen-orientation-3.0.5.tgz","fileCount":10,"unpackedSize":68460,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFZF9So1VO6ypV+aRHx8RWGrkG84d6nBpUdX34bs+Vs8AiAKlFOKbzTp5h78Z//YRvACd5YR22miTnClJ+8t5owA6Q=="}]},"_npmUser":{"name":"luqi_tan","email":"295099422@qq.com"},"directories":{},"maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"},{"name":"wanpengsz","email":"wanpengsz@163.com"},{"name":"xkh111","email":"xukaihui11@163.com"},{"name":"hcordova","email":"chenlihuiabc@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cordova-plugin-screen-orientation_3.0.5_1785143155291_0.9969253750773788"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-18T09:46:51.777Z","modified":"2026-07-27T09:05:55.675Z","3.0.4":"2026-03-18T09:46:52.051Z","3.0.5":"2026-07-27T09:05:55.438Z"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-screen-orientation/issues"},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","keywords":["cordova","screen-orientation","ecosystem:cordova","cordova-openharmony"],"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-screen-orientation"},"description":"Cordova Screen Orientation Plugin","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"},{"name":"wanpengsz","email":"wanpengsz@163.com"},{"name":"xkh111","email":"xukaihui11@163.com"},{"name":"hcordova","email":"chenlihuiabc@163.com"}],"readme":"# <center>cordova-plugin-screen-orientation</center>\r\n\r\n[![zh-CN](https://img.shields.io/badge/lang-中文-blue.svg)](README.md)\r\n[![en](https://img.shields.io/badge/lang-English-blue.svg)](README.en.md)\r\n\r\n本项目基于 [cordova-plugin-screen-orientation@3.0.4](https://npmjs.com/package/cordova-plugin-screen-orientation/v/3.0.4) 开发，本文档重点阐述其在 OpenHarmony（OHOS）系统中的具体应用。\r\n\r\n- [cordova-plugin-screen-orientation](#cordova-plugin-screen-orientation)\r\n  - [简介](#简介)\r\n  - [功能特性](#功能特性)\r\n  - [支持平台](#支持平台)\r\n  - [前置准备](#前置准备)\r\n  - [下载安装](#下载安装)\r\n    - [前提条件](#前提条件)\r\n    - [指定平台安装 ohos](#指定平台安装-ohos)\r\n    - [从 GitCode 仓库安装](#从-gitcode-仓库安装)\r\n    - [安装指定版本](#安装指定版本)\r\n    - [离线安装（本地包）](#离线安装本地包)\r\n    - [安装后验证](#安装后验证)\r\n    - [卸载](#卸载)\r\n  - [OHOS 配置](#ohos-配置)\r\n  - [约束与限制](#约束与限制)\r\n    - [兼容性](#兼容性)\r\n  - [使用示例](#使用示例)\r\n    - [1. 锁定屏幕方向](#1-锁定屏幕方向)\r\n    - [2. 解锁屏幕方向](#2-解锁屏幕方向)\r\n    - [3. 获取当前屏幕方向](#3-获取当前屏幕方向)\r\n    - [4. 监听屏幕方向变化](#4-监听屏幕方向变化)\r\n  - [使用说明](#使用说明)\r\n    - [1. 核心 API 说明](#1-核心-api-说明)\r\n      - [1.1 lock：锁定屏幕方向](#11-lock锁定屏幕方向)\r\n      - [1.2 unlock：解锁屏幕方向](#12-unlock解锁屏幕方向)\r\n      - [1.3 type：获取当前屏幕方向](#13-type获取当前屏幕方向)\r\n      - [1.4 方向变化事件监听](#14-方向变化事件监听)\r\n    - [2. 关键参数说明](#2-关键参数说明)\r\n    - [3. 注意事项](#3-注意事项)\r\n  - [目录结构](#目录结构)\r\n  - [贡献代码](#贡献代码)\r\n  - [许可证](#许可证)\r\n  - [官方资源](#官方资源)\r\n\r\n## 简介\r\n\r\n`cordova-plugin-screen-orientation` 是一款用于在 Cordova 应用中设置和锁定屏幕方向的插件。该插件提供简洁的 API，可实现屏幕方向控制，包括锁定至特定方向（竖屏、横屏等）以及监听方向变化事件。插件允许 Cordova 开发者控制移动应用的屏幕方向，支持将屏幕锁定至特定方向（如竖屏、左侧横屏等），并能检测设备方向的变化，本文档主要介绍该插件在 OHOS 系统中的应用。\r\n\r\n## 功能特性\r\n\r\n- **方向锁定**：支持将屏幕锁定至特定方向模式（主竖屏、副竖屏、主横屏、副横屏等）\r\n\r\n- **方向解锁**：可解锁屏幕方向，允许设备根据传感器自动旋转屏幕\r\n\r\n- **方向获取**：实时获取当前屏幕所处的方向模式，便于适配页面布局\r\n\r\n- **事件监听**：支持注册屏幕方向变化监听器，实时检测方向变更并触发对应逻辑\r\n\r\n- **多平台适配**：兼容 Android、iOS、Windows、浏览器及 OHOS 多平台，支持各平台专属配置选项\r\n\r\n- **简洁易用**：API 接口简洁直观，无需深入原生开发，快速上手集成\r\n\r\n- **无侵入性**：插件集成后不影响应用原有逻辑，轻量化运行，不占用过多设备资源\r\n\r\n## 支持平台\r\n\r\n- **Android**（API 级别 14 及以上）\r\n\r\n- **iOS**（iOS 9.0 及以上）\r\n\r\n- **Windows**（Windows 10 及以上）\r\n\r\n- **浏览器**（Chrome、Firefox、Safari）\r\n\r\n- **OHOS**（5.0 及以上）\r\n\r\n## 前置准备\r\n\r\n在集成插件前，确保开发环境已满足以下基础条件，无需额外在第三方平台注册配置：\r\n\r\n- 已安装 Node.js（v14.0.0 及以上）和 npm（v6.0.0 及以上）\r\n\r\n- 已安装 HCordova CLI（10.0.0 及以上），用于插件的安装、卸载和管理\r\n\r\n- 已创建 Cordova 项目（若未创建，可通过 `cordova create screenOrientationApp com.example.screenorientationapp ScreenOrientationApp` 命令创建）\r\n\r\n## 下载安装\r\n\r\n通过 hcordova CLI 即可快速安装插件，支持全平台安装或指定 OHOS 平台安装，安装流程简洁高效。\r\n\r\n### 前提条件\r\n\r\n安装插件前，需先安装 HCordova CLI，执行以下命令安装：\r\n\r\n```bash\r\n# 使用 hcordova CLI 安装\r\n# 安装 hcordova 命令化工具\r\nnpm install -g hcordova\r\n\r\n# 全平台安装插件\r\nhcordova plugin add cordova-plugin-screen-orientation\r\n```\r\n\r\n### 指定平台安装 ohos\r\n\r\n仅为 OHOS 平台安装插件：\r\n\r\n```bash\r\n# 仅安装到 OHOS 平台\r\nhcordova plugin add cordova-plugin-screen-orientation --platform ohos\r\n```\r\n\r\n### 从 GitCode 仓库安装\r\n\r\n仅为 OHOS 平台安装插件：\r\n\r\n```bash\r\n# 仅安装到 OHOS 平台\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-screen-orientation.git --platform ohos\r\n\r\n# 指定标签/分支安装\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-screen-orientation.git@develop --platform ohos\r\n```\r\n\r\n### 安装指定版本\r\n\r\n```bash\r\n# 仅安装到 OHOS 平台指定版本\r\nhcordova plugin add cordova-plugin-screen-orientation@1.0.0 --platform ohos\r\n```\r\n\r\n### 离线安装（本地包）\r\n\r\n适用于无网络环境，先下载插件包到本地，再执行离线安装：\r\n\r\n```bash\r\n# 下载插件包到本地（示例路径：~/Downloads/cordova-plugin-screen-orientation）\r\n# 执行离线安装\r\nhcordova plugin add ~/Downloads/cordova-plugin-screen-orientation  --platform ohos\r\n```\r\n\r\n### 安装后验证\r\n\r\n安装完成后，可通过以下命令验证插件是否成功添加到项目中：\r\n\r\n```bash\r\n# 查看已安装的插件列表，若包含本插件 ID 则表示插件已成功安装\r\nhcordova plugin list\r\n```\r\n\r\n\r\n### 卸载\r\n\r\n如需移除插件，进入项目根目录执行以下命令，卸载后建议重新构建项目以清理残留文件：\r\n\r\n```bash\r\n# 全平台卸载\r\nhcordova plugin remove cordova-plugin-screen-orientation\r\n\r\n# 指定 OHOS 卸载\r\nhcordova plugin remove cordova-plugin-screen-orientation --platform ohos\r\n```\r\n\r\n## OHOS 配置\r\n\r\nOHOS 平台集成插件后，无需额外进行复杂配置，安装完成并重新构建项目后即可正常使用。若出现方向控制异常，可检查以下几点：\r\n\r\n- 确保项目 SDK 版本为 API12+，DevEco Studio 版本为 5.0+，符合兼容性要求\r\n\r\n- 重新构建项目（执行 `hcordova build ohos`），确保插件资源正确加载\r\n\r\n- 检查设备是否开启屏幕自动旋转权限，部分方向模式需依赖设备传感器支持\r\n\r\n## 约束与限制\r\n\r\n- 依赖插件：无强制依赖，可直接集成到 Cordova 项目中使用\r\n\r\n- 方向模式限制：部分方向模式并非在所有平台都支持（例如，多数 Android 设备默认不支持 `portrait-secondary` 倒置竖屏模式），OHOS 平台支持主流方向模式（主竖屏、主横屏、任意竖屏、任意横屏）\r\n\r\n- 设备权限限制：部分设备需开启屏幕自动旋转权限，否则方向解锁后可能无法正常自动旋转\r\n\r\n- 事件监听限制：屏幕方向变化事件需在 `deviceready` 事件触发后注册，否则可能无法正常监听\r\n\r\n### 兼容性\r\n\r\n支持：\r\n\r\n| 项目 | 版本/信息 |\r\n|-----|--------|\r\n| SDK | API12+ |\r\n| IDE | DevEco Studio: 5.0+ |\r\n| ROM | 5.1+ |\r\n| Emulator | OpenHarmony 6.0+ |\r\n\r\n在以下版本中已测试通过：\r\n\r\n| 项目 | 版本/信息 |\r\n|-----|--------|\r\n| @cordova-ohos/ohos | 14.0.1-ohos-14.0.1 |\r\n| SDK | 5.0.0(12) |\r\n| IDE | DevEco Studio: 6.0.13.200 |\r\n| ROM | 5.1.0.120 SP3 |\r\n| Emulator | OpenHarmony 6.0.1(21) |\r\n\r\n## 使用示例\r\n\r\n插件所有方法均在全局对象 `screen.orientation` 下可用，所有 API 均需在 `deviceready` 事件触发后调用。以下为各核心功能的完整使用示例，可直接复制到项目中使用。\r\n\r\n### 1. 锁定屏幕方向\r\n\r\n将屏幕锁定至指定的方向模式（示例为锁定横屏），支持 Promise 链式调用处理成功与失败场景：\r\n\r\n```javascript\r\n// 等待 Cordova 加载完成\r\ndocument.addEventListener('deviceready', () => {\r\n // 锁定屏幕为横屏模式（支持 landscape、portrait 等模式）\r\n screen.orientation.lock('landscape')\r\n   .then(() => {\r\n     console.log('屏幕已锁定为横屏');\r\n   })\r\n   .catch((error) => {\r\n     console.error('横屏锁定失败：', error);\r\n   });\r\n}, false);\r\n```\r\n\r\n### 2. 解锁屏幕方向\r\n\r\n解锁屏幕方向，允许设备根据传感器自动旋转，示例为锁定竖屏 5 秒后自动解锁：\r\n\r\n```javascript\r\ndocument.addEventListener('deviceready', () => {\r\n // 先将屏幕锁定为竖屏\r\n screen.orientation.lock('portrait')\r\n   .then(() => {\r\n     console.log('屏幕已锁定为竖屏');\r\n     // 5 秒后解锁方向，开启自动旋转\r\n     setTimeout(() => {\r\n       screen.orientation.unlock();\r\n       console.log('屏幕方向已解锁（开启自动旋转）');\r\n     }, 5000);\r\n   });\r\n}, false);\r\n```\r\n\r\n### 3. 获取当前屏幕方向\r\n\r\n获取当前屏幕所处的方向模式，并打印输出：\r\n\r\n```javascript\r\ndocument.addEventListener('deviceready', () => {\r\n const currentOrientation = screen.orientation.type;\r\n console.log('当前屏幕方向：', currentOrientation);\r\n // 示例输出：\"portrait-primary\"（主竖屏）或 \"landscape-secondary\"（副横屏）\r\n}, false);\r\n```\r\n\r\n### 4. 监听屏幕方向变化\r\n\r\n注册屏幕方向变化监听器，实时检测方向变更并更新页面 UI：\r\n\r\n```javascript\r\ndocument.addEventListener('deviceready', () => {\r\n // 添加方向变化监听器\r\n screen.orientation.addEventListener('change', (event) => {\r\n   const newOrientation = event.type;\r\n   const orientationElement = document.getElementById('orientation-status');\r\n   // 更新 UI 显示当前方向\r\n   orientationElement.textContent = \"当前屏幕方向：\"+newOrientation;\r\n   // 根据方向调整页面布局\r\n   if (newOrientation.includes('portrait')) {\r\n     document.body.classList.add('portrait-layout');\r\n     document.body.classList.remove('landscape-layout');\r\n   } else {\r\n     document.body.classList.add('landscape-layout');\r\n     document.body.classList.remove('portrait-layout');\r\n   }\r\n });\r\n\r\n // （可选）移除监听器示例\r\n const handleOrientationChange = (event) => {\r\n   console.log('屏幕方向变更：', event.type);\r\n };\r\n // 注册监听器\r\n screen.orientation.addEventListener('change', handleOrientationChange);\r\n // 后续需要时移除监听器\r\n // screen.orientation.removeEventListener('change', handleOrientationChange);\r\n}, false);\r\n```\r\n\r\n## 使用说明\r\n\r\n以下为插件使用的核心说明，包括 API 详解、参数说明、注意事项等，帮助开发者快速上手并避免异常。\r\n\r\n### 1. 核心 API 说明\r\n\r\n插件所有方法均挂载在全局 `screen.orientation` 对象上，无需额外引入，需在 Cordova 加载完成后（`deviceready` 事件触发后）调用，否则会出现 API 未定义、调用失败等异常。\r\n\r\n#### 1.1 lock：锁定屏幕方向\r\n\r\n功能：将屏幕锁定至指定的方向模式，锁定后屏幕将无法自动旋转，仅保持指定方向。\r\n\r\n语法：\r\n\r\n```javascript\r\nscreen.orientation.lock(orientationMode)\r\n .then(() => { /* 成功回调 */ })\r\n .catch((error) => { /* 失败回调 */ });\r\n```\r\n\r\n参数说明：\r\n\r\n- orientationMode（必传）：字符串类型，指定锁定的方向模式，可选值如下（多数平台支持）：\r\n        \r\n\r\n    - `portrait-primary`：主竖屏模式（设备默认的竖屏方向）\r\n\r\n    - `portrait-secondary`：副竖屏模式（倒置竖屏，即屏幕上下翻转）\r\n\r\n    - `landscape-primary`：主横屏模式（设备默认的横屏方向，通常为右侧横屏）\r\n\r\n    - `landscape-secondary`：副横屏模式（与主横屏相反的方向，通常为左侧横屏）\r\n\r\n    - `portrait`：锁定至任意竖屏模式（包含主竖屏和副竖屏）\r\n\r\n    - `landscape`：锁定至任意横屏模式（包含主横屏和副横屏）\r\n\r\n    - `any`：允许任意方向（自动旋转，效果等同于解锁方向）\r\n\r\n- 成功回调：锁定成功时触发，无返回参数。\r\n\r\n- 失败回调：锁定失败时触发，返回错误信息对象，用于排查问题（如不支持该方向模式、权限不足等）。\r\n\r\n#### 1.2 unlock：解锁屏幕方向\r\n\r\n功能：解锁屏幕方向，取消锁定状态，允许设备根据传感器自动旋转屏幕。\r\n\r\n语法：\r\n\r\n```javascript\r\nscreen.orientation.unlock();\r\n```\r\n\r\n参数说明：无参数，调用后立即生效。\r\n\r\n#### 1.3 type：获取当前屏幕方向\r\n\r\n功能：获取当前屏幕所处的方向模式，返回值与 lock 方法的 orientationMode 参数一致。\r\n\r\n语法：\r\n\r\n```javascript\r\nconst currentOrientation = screen.orientation.type;\r\n```\r\n\r\n返回值：字符串类型，对应屏幕当前的方向模式（如 `portrait-primary`、`landscape`）。\r\n\r\n#### 1.4 方向变化事件监听\r\n\r\n功能：注册或移除屏幕方向变化监听器，实时检测屏幕方向的变更，触发对应业务逻辑。\r\n\r\n语法：\r\n\r\n```javascript\r\n// 添加监听器\r\nscreen.orientation.addEventListener('change', (event) => { /* 方向变化逻辑 */ });\r\n\r\n// 移除监听器\r\nscreen.orientation.removeEventListener('change', 监听器函数);\r\n```\r\n\r\n参数说明：\r\n\r\n- change：固定事件名称，标识屏幕方向变化事件。\r\n\r\n- 监听器函数：事件触发时执行的函数，接收 event 参数，event.type 为变更后的方向模式。\r\n\r\n### 2. 关键参数说明\r\n\r\n| 参数名称 | 类型 | 说明 | 是否必填 |\r\n|---|---|---|---|\r\n| orientationMode | 字符串 | 锁定屏幕的方向模式，可选值见 1.1 lock 方法的参数说明 | 是（lock 方法） |\r\n| event | 对象 | 方向变化事件对象，包含 type 属性（变更后的方向模式） | 是（监听器函数） |\r\n\r\n### 3. 注意事项\r\n\r\n- API 调用时机：所有 API 必须在 `deviceready` 事件触发后调用，否则会出现 screen.orientation 未定义、调用失败等异常。\r\n\r\n- 方向模式兼容性：部分方向模式（如 `portrait-secondary`）并非在所有平台都支持，建议根据目标平台选择合适的方向模式，避免兼容性问题。\r\n\r\n- 设备权限：部分设备需开启屏幕自动旋转权限，否则方向解锁后可能无法正常自动旋转，建议在应用中提示用户开启权限。\r\n\r\n- 监听器管理：若不再需要监听屏幕方向变化，需及时移除监听器，避免内存泄漏。\r\n\r\n- OHOS 特殊说明：OHOS 平台支持主流方向模式，若出现方向控制异常，可重新构建项目或检查设备传感器是否正常。\r\n\r\n- 错误处理：建议在 lock 方法的 catch 回调中添加错误日志打印，便于排查锁定失败的原因（如不支持的方向模式、设备限制等）。\r\n\r\n## 目录结构\r\n\r\n```\r\ncordova-plugin-screen-orientation  # [根目录] 屏幕方向控制插件项目根目录\r\n├── src                            # [源码目录] 存放原生平台代码\r\n│   └── main                       # [主目录] 主代码目录\r\n│       ├── cpp                    # [C++ 目录] C++ 原生代码目录\r\n│       │   └── CDVOrientation     # [C++ 模块] 屏幕方向 C++ 模块文件夹\r\n│       │       ├── CDVOrientation.cpp # [C++ 实现] C++ 源文件，实现方向控制的底层逻辑\r\n│       │       └── CDVOrientation.h   # [C++ 声明] C++ 头文件，定义方向控制接口\r\n│       └── ets                    # [ArkTS 目录] ArkTS/ETS 代码目录\r\n│           └── components         # [组件目录] 存放逻辑组件\r\n│               └── PluginAction   # [TS 模块] 插件动作逻辑文件夹\r\n│                   └── SetScreenOrientation.ets # [ETS 文件] 设置屏幕方向的具体 ArkTS 实现\r\n├── www                            # [前端目录] 存放供 Web 端调用的 JS 接口文件\r\n│   └── screenorientation.js       # [JS 文件] 暴露给 Web 端的屏幕方向控制接口\r\n├── .gitignore                     # [配置文件] Git 版本控制忽略配置\r\n├── LICENSE                        # [文本文件] 开源许可证\r\n├── OAT.xml                        # [配置文件] 门禁配置文件\r\n├── package.json                   # [配置文件] 项目元数据及依赖管理\r\n├── plugin.xml                     # [配置文件] Cordova 插件核心配置文件\r\n└── README.md                      # [文档] 项目说明文档\r\n```\r\n\r\n## 贡献代码\r\n\r\n使用过程中发现任何问题都可以提 [Issue](https://gitcode.com/CPF-Cordova/cordova-plugin-screen-orientation/issues) ，当然也非常欢迎发 [PR](https://gitcode.com/CPF-Cordova/cordova-plugin-screen-orientation/pulls) 共建。\r\n\r\n## 许可证\r\n\r\n本插件基于 **Apache License 2.0** 开源，详见 [LICENSE](LICENSE) 文件。\r\n\r\n## 官方资源\r\n\r\n- GitHub Android/iOS 仓库：[apache/cordova-plugin-screen-orientation](https://github.com/apache/cordova-plugin-screen-orientation)\r\n\r\n- 问题反馈：[GitHub Issues](https://github.com/apache/cordova-plugin-screen-orientation/issues)\r\n\r\n- OHOS：[GitCode](https://gitcode.com/CPF-Cordova/cordova-plugin-screen-orientation)\r\n","readmeFilename":"README.md"}