{"_id":"@cordova-ohos/cordova-plugin-splashscreen","_rev":"5-58fef9b6552f1ee4c5a1357f3df599fe","name":"@cordova-ohos/cordova-plugin-splashscreen","dist-tags":{"latest":"6.0.3"},"versions":{"6.0.2":{"name":"@cordova-ohos/cordova-plugin-splashscreen","version":"6.0.2","keywords":["cordova","splashscreen","ecosystem:cordova","cordova-openharmony"],"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","_id":"@cordova-ohos/cordova-plugin-splashscreen@6.0.2","maintainers":[{"name":"luqi_tan","email":"295099422@qq.com"}],"bugs":{"url":"https://gitcode.com/OpenHarmony-Cordova/cordova-plugin-splashscreen/issues"},"dist":{"shasum":"010d971453be306f6e9f8b4373175bffbd7ca275","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-splashscreen/-/cordova-plugin-splashscreen-6.0.2.tgz","fileCount":8,"integrity":"sha512-bOgQFTR+SKgpC53aKashwlZvY5OudjRJQF0nznGDHXAosNo4Ye1KTtn73YvZgytO70mzXWqZX1tjpNQzP04CHA==","signatures":[{"sig":"MEUCIQD+3ArChkVdDwwMKjF603Q7FkuPKqEJVUQ8wZwdtqho7wIgZ/NLPvBCKvZaFfWuZnQPRhzIdVErGDSmci7t2y0XJwI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28206},"cordova":{"id":"cordova-plugin-splashscreen","platforms":["ohos"]},"engines":{"cordovaDependencies":{"6.0.2":{"hcordova":">=1.0.0","@cordova-ohos/ohos":">=2.0.0"}}},"gitHead":"97567e4170757349d54099c758cf3eee449ebda9","_npmUser":{"name":"luqi_tan","email":"295099422@qq.com"},"repository":{"url":"gitcode:OpenHarmony-Cordova/cordova-plugin-splashscreen","type":"git"},"_npmVersion":"10.5.1","description":"Cordova Splashscreen Plugin","directories":{},"_nodeVersion":"22.0.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cordova-plugin-splashscreen_6.0.2_1773924719375_0.48570637034694997","host":"s3://npm-registry-packages-npm-production"}},"6.0.3":{"name":"@cordova-ohos/cordova-plugin-splashscreen","version":"6.0.3","description":"Cordova Splash Screen Plugin","cordova":{"id":"cordova-plugin-splashscreen","platforms":["ohos"]},"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-splashscreen"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-splashscreen/issues"},"keywords":["cordova","splashscreen","ecosystem:cordova","cordova-openharmony"],"engines":{"cordovaDependencies":{"6.0.3":{"@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-splashscreen@6.0.3","gitHead":"52980eff9e5d83b9269f9ec3283069a4a33cf8e6","_nodeVersion":"22.0.0","_npmVersion":"10.5.1","dist":{"integrity":"sha512-/Tj035a0J0aDs/19sN12SBa+DaFeWARobf2Y0+/ii+4G0xr2zPXcdB5bV/vmwOIyuihWsCRxubLkpGtibBTscw==","shasum":"f0ad737beada5bb631da0903c633fdbb08ccc6c2","tarball":"https://registry.npmjs.org/@cordova-ohos/cordova-plugin-splashscreen/-/cordova-plugin-splashscreen-6.0.3.tgz","fileCount":9,"unpackedSize":63343,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAb+kiS2fOsnyDyck36TCjteKHOjo8bO1MN4a/1v+5KHAiEAiN4v4KU6+nDjr7gAWfqiBbcExYzT1VLR1fUhXW+xDNY="}]},"_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-splashscreen_6.0.3_1785142240165_0.9299385840045304"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-19T12:51:59.295Z","modified":"2026-07-27T08:50:40.510Z","6.0.2":"2026-03-19T12:51:59.523Z","6.0.3":"2026-07-27T08:50:40.297Z"},"bugs":{"url":"https://gitcode.com/CPF-Cordova/cordova-plugin-splashscreen/issues"},"author":{"name":"Huawei Device, Inc. Ltd. and","email":"马弓手"},"license":"Apache-2.0","keywords":["cordova","splashscreen","ecosystem:cordova","cordova-openharmony"],"repository":{"type":"git","url":"gitcode:CPF-Cordova/cordova-plugin-splashscreen"},"description":"Cordova Splash Screen 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-splashscreen</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-splashscreen@6.0.2](https://npmjs.com/package/cordova-plugin-splashscreen/v/6.0.2) 开发，本文档重点阐述其在 OpenHarmony（OHOS）系统中的具体应用。\r\n\r\n- [cordova-plugin-splashscreen](#cordova-plugin-splashscreen)\r\n  - [简介](#简介)\r\n  - [功能特性](#功能特性)\r\n  - [支持平台](#支持平台)\r\n  - [前置准备](#前置准备)\r\n  - [下载安装](#下载安装)\r\n    - [前提条件](#前提条件)\r\n    - [从 npm 安装（基础安装）](#从-npm-安装基础安装)\r\n    - [从 GitCode 仓库安装（开发版）](#从-gitcode-仓库安装开发版)\r\n    - [离线安装（本地包）](#离线安装本地包)\r\n    - [安装后验证](#安装后验证)\r\n    - [卸载](#卸载)\r\n  - [OHOS 配置](#ohos-配置)\r\n    - [1. 核心配置（config.xml）](#1-核心配置configxml)\r\n    - [2. 图片资源配置](#2-图片资源配置)\r\n  - [约束与限制](#约束与限制)\r\n    - [兼容性](#兼容性)\r\n  - [使用示例](#使用示例)\r\n    - [1. 自动显示/隐藏（默认用法）](#1-自动显示隐藏默认用法)\r\n    - [2. 手动隐藏启动屏](#2-手动隐藏启动屏)\r\n    - [3. 手动显示启动屏（应用运行中）](#3-手动显示启动屏应用运行中)\r\n    - [4. 完整配置+API 组合示例](#4-完整配置api-组合示例)\r\n  - [使用说明](#使用说明)\r\n    - [1. 核心 API 说明](#1-核心-api-说明)\r\n      - [1.1 hide：隐藏启动屏](#11-hide隐藏启动屏)\r\n      - [1.2 show：显示启动屏](#12-show显示启动屏)\r\n    - [2. 核心配置参数说明](#2-核心配置参数说明)\r\n    - [3. 常见问题（FAQ）](#3-常见问题faq)\r\n      - [Q1: 启动屏不显示怎么办？](#q1-启动屏不显示怎么办)\r\n      - [Q2: 启动屏无法隐藏怎么办？](#q2-启动屏无法隐藏怎么办)\r\n    - [4. 注意事项](#4-注意事项)\r\n  - [目录结构](#目录结构)\r\n  - [贡献代码](#贡献代码)\r\n  - [许可证](#许可证)\r\n  - [官方资源](#官方资源)\r\n\r\n\r\n## 简介\r\n\r\n`cordova-plugin-splashscreen` 是 Cordova 启动屏（Splash Screen）插件，用于在应用启动过程中显示预设图片，掩盖加载时的白屏或初始化状态，提升用户体验。支持自动/手动控制启动屏显示/隐藏，适配 Android、iOS、OHOS 等多平台多分辨率设备。本文重点说明该插件在 OHOS 系统中的使用方法、配置及注意事项。\r\n\r\n## 功能特性\r\n\r\n- **自动显示**：启动时自动显示启动屏，无需额外编写代码，简化集成流程\r\n\r\n- **延迟控制**：可配置自动隐藏延迟时间，默认在 web 页面加载完毕后自动隐藏\r\n\r\n- **手动控制**：支持 JavaScript API 手动控制启动屏显示/隐藏，适配复杂初始化场景（如等待异步接口请求完成）\r\n\r\n- **多平台适配**：兼容 Android、iOS、OHOS 等 Cordova 支持的主流平台\r\n\r\n- **多分辨率兼容**：支持为不同屏幕密度、尺寸的设备配置专属启动屏图片，保证显示效果\r\n\r\n- **灵活配置**：支持透明背景、淡入淡出动画效果，可根据应用风格自定义启动屏表现\r\n\r\n- **spinner 支持**：可配置显示加载指示器（spinner），并自定义其颜色，提升加载反馈体验\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- **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 及以上），且支持 cordova-openharmony 2.0.0+，用于插件的安装、卸载和管理\r\n\r\n- 已创建 Cordova 项目（若未创建，可通过 `cordova create splashScreenApp com.example.splashscreenapp SplashScreenApp` 命令创建）\r\n\r\n- 准备好适配 OHOS 平台的启动屏图片（竖屏：splash_portrait，横屏：splash_landscape），用于后续配置\r\n\r\n## 下载安装\r\n\r\n通过 hcordova CLI 即可快速安装插件，支持全平台安装、指定 OHOS 平台安装，也可从 GitCode 仓库获取最新开发版，安装流程简洁高效。\r\n\r\n### 前提条件\r\n\r\n安装插件前，需先安装 HCordova CLI，执行以下命令安装：\r\n\r\n```bash\r\nnpm install -g hcordova\r\n```\r\n\r\n### 从 npm 安装（基础安装）\r\n\r\n```bash\r\n# 安装最新稳定版（全平台）\r\nhcordova plugin add cordova-plugin-splashscreen\r\n\r\n# 指定 OHOS 平台安装\r\nhcordova plugin add cordova-plugin-splashscreen --platform ohos\r\n\r\n# 指定版本安装\r\nhcordova plugin add cordova-plugin-splashscreen@1.0.0 --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-splashscreen.git --platform ohos\r\n# 指定标签/分支安装\r\nhcordova plugin add https://gitcode.com/CPF-Cordova/cordova-plugin-splashscreen.git@develop --platform ohos\r\n```\r\n\r\n### 离线安装（本地包）\r\n\r\n适用于无网络环境，先下载插件包到本地，再执行离线安装：\r\n\r\n```bash\r\n# 下载插件包到本地（示例路径：~/Downloads/cordova-plugin-splashscreen）\r\n# 执行离线安装\r\nhcordova plugin add ~/Downloads/cordova-plugin-splashscreen  --platform ohos\r\n```\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-splashscreen\r\n\r\n# 指定 OHOS 卸载\r\nhcordova plugin remove cordova-plugin-splashscreen --platform ohos\r\n```\r\n\r\n## OHOS 配置\r\n\r\nOHOS 平台集成插件后，需完成基础配置（config.xml）和图片资源配置，确保启动屏正常显示，具体配置如下：\r\n\r\n### 1. 核心配置（config.xml）\r\n\r\n所有启动屏相关配置需在项目根目录的 `config.xml` 中声明，以下是完整配置示例，可根据需求调整参数值：\r\n\r\n```xml\r\n<!-- 在 web 加载完成后，自动隐藏启动屏 -->\r\n<preference name=\"AutoHideSplashScreen\" value=\"true\" />\r\n\r\n<!-- web 加载完成后，延迟指定时间（毫秒）关闭启动屏（0 禁用启动屏） -->\r\n<preference name=\"SplashScreenDelay\" value=\"3000\" />\r\n\r\n<!-- 显示加载指示器（Spinner），true 显示，false 隐藏 -->\r\n<preference name=\"ShowSplashScreenSpinner\" value=\"true\"/>\r\n\r\n<!-- 启动屏全屏显示，宽高比和屏幕一致，true 全屏，false 非全屏 -->\r\n<preference name=\"SplashMaintainAspectRatio\" value=\"true\"/>\r\n\r\n<!-- 设置 Spinner 颜色（支持十六进制颜色值） -->\r\n<preference name=\"SplashScreenSpinnerColor\" value=\"#ffffff\"/>\r\n\r\n<!-- 启动屏消失动画持续时间（毫秒） -->\r\n<preference name=\"FadeSplashScreenDuration\" value=\"2000\"/>\r\n\r\n<!-- 启动屏关闭后，应用是否保持全屏显示，true 全屏，false 非全屏 -->\r\n<preference name=\"FullScreenAfterCloseSplash\" value=\"false\" />\r\n```\r\n\r\n### 2. 图片资源配置\r\n\r\nOHOS 平台启动屏图片需按以下要求放置，无需在 config.xml 中额外配置图片名称：\r\n\r\n- 图片名称：竖屏启动屏图片命名为 `splash_portrait`，横屏启动屏图片命名为 `splash_landscape`\r\n\r\n- 存放路径：将图片放置在项目的 `resource/media` 目录下\r\n\r\n- 注意事项：若图片资源不存在，启动屏将无法正常启动或启动失败，建议适配不同分辨率设备，确保显示清晰\r\n\r\n## 约束与限制\r\n\r\n- 依赖插件：无强制依赖，可直接集成到 Cordova 项目中使用，需确保 HCordova CLI 版本支持 @cordova-ohos/ohos 2.0.0+\r\n\r\n- 配置限制：启动屏相关配置均需在 config.xml 中声明，参数值错误或缺失会导致启动屏异常（如不显示、无法隐藏）\r\n\r\n- 图片限制：OHOS 平台启动屏图片必须按指定名称和路径放置，否则启动屏无法正常显示\r\n\r\n- API 调用限制：JavaScript API 需在 `deviceready` 事件触发后调用，否则会出现 API 未定义、调用失败等异常\r\n\r\n- 自动隐藏限制：若设置 `AutoHideSplashScreen=\"false\"`，web 页面加载完毕后启动屏不会自动隐藏，需手动调用 `hide()` 隐藏\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插件支持自动显示/隐藏启动屏（无需额外代码），也可通过 JavaScript API 手动控制，适用于复杂初始化场景。以下为各核心功能的完整使用示例，可直接复制到项目中使用。\r\n\r\n### 1. 自动显示/隐藏（默认用法）\r\n\r\n无需编写 JavaScript 代码，只需在 config.xml 中配置相关参数，启动屏将自动显示，按配置规则自动隐藏：\r\n\r\n```xml\r\n<!-- config.xml 核心配置 -->\r\n<preference name=\"AutoHideSplashScreen\" value=\"true\" />\r\n<preference name=\"SplashScreenDelay\" value=\"3000\" /> <!-- 延迟 3 秒隐藏 -->\r\n<preference name=\"ShowSplashScreenSpinner\" value=\"true\"/>\r\n<preference name=\"SplashScreenSpinnerColor\" value=\"#ffffff\"/>\r\n```\r\n\r\n效果：应用启动后显示启动屏，web 页面加载完成后，延迟 3 秒自动隐藏，期间显示白色加载指示器。\r\n\r\n### 2. 手动隐藏启动屏\r\n\r\n适用于复杂场景（如等待异步接口请求完成后隐藏），需在 `deviceready` 事件触发后调用 API：\r\n\r\n```javascript\r\n// 等待 Cordova 加载完成\r\ndocument.addEventListener(\"deviceready\", () => {\r\n    // 基础用法：立即隐藏\r\n    navigator.splashscreen.hide();\r\n\r\n    // 配合延迟（例如等待 2 秒后隐藏）\r\n    setTimeout(() => {\r\n        navigator.splashscreen.hide();\r\n    }, 2000);\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    // 页面跳转时显示启动屏\r\n    navigator.splashscreen.show();\r\n    \r\n    // 模拟数据加载，加载完成后隐藏\r\n    setTimeout(() => {\r\n        navigator.splashscreen.hide();\r\n    }, 3000);\r\n}, false);\r\n```\r\n\r\n### 4. 完整配置+API 组合示例\r\n\r\n结合 config.xml 配置和 API 手动控制，实现复杂场景下的启动屏管理：\r\n\r\n```xml\r\n<!-- config.xml 配置 -->\r\n<preference name=\"AutoHideSplashScreen\" value=\"false\" /> <!-- 关闭自动隐藏 -->\r\n<preference name=\"ShowSplashScreenSpinner\" value=\"true\"/>\r\n<preference name=\"SplashScreenSpinnerColor\" value=\"#000000\"/>\r\n<preference name=\"FadeSplashScreenDuration\" value=\"1500\"/>\r\n```\r\n\r\n```javascript\r\n// JavaScript 代码\r\ndocument.addEventListener(\"deviceready\", () => {\r\n    // 等待异步接口请求完成（模拟）\r\n    fetch(\"https://api.example.com/init\")\r\n        .then(response => response.json())\r\n        .then(data => {\r\n            console.log(\"初始化完成，隐藏启动屏\");\r\n            // 接口请求完成后，手动隐藏启动屏（带淡入淡出动画）\r\n            navigator.splashscreen.hide();\r\n        })\r\n        .catch(error => {\r\n            console.error(\"初始化失败，隐藏启动屏\", error);\r\n            navigator.splashscreen.hide();\r\n        });\r\n}, false);\r\n```\r\n\r\n## 使用说明\r\n\r\n以下为插件使用的核心说明，包括 API 详解、参数说明、注意事项等，帮助开发者快速上手并避免异常。\r\n\r\n### 1. 核心 API 说明\r\n\r\n插件所有 API 均挂载在 `navigator.splashscreen` 对象上，无需额外引入，需在 Cordova 加载完成后（`deviceready` 事件触发后）调用，否则会出现 API 未定义、调用失败等异常。\r\n\r\n#### 1.1 hide：隐藏启动屏\r\n\r\n功能：手动隐藏启动屏，可配合延迟使用，支持淡入淡出动画（需在 config.xml 中配置 `FadeSplashScreenDuration`）。\r\n\r\n语法：\r\n\r\n```javascript\r\nnavigator.splashscreen.hide();\r\n```\r\n\r\n参数说明：无参数，调用后立即执行隐藏操作（若配置了动画，将按动画时长逐步隐藏）。\r\n\r\n#### 1.2 show：显示启动屏\r\n\r\n功能：在应用运行中手动显示启动屏，适用于数据加载、页面跳转等场景，显示效果与启动时一致。\r\n\r\n语法：\r\n\r\n```javascript\r\nnavigator.splashscreen.show();\r\n```\r\n\r\n参数说明：无参数，调用后立即显示启动屏，需手动调用 `hide()` 方法隐藏。\r\n\r\n### 2. 核心配置参数说明\r\n\r\n| 配置名称 | 类型 | 说明 | 默认值 |\r\n|---|---|---|---|\r\n| AutoHideSplashScreen | 布尔值 | web 页面加载完成后，是否自动隐藏启动屏；false 时需手动调用 hide() 隐藏 | true |\r\n| SplashScreenDelay | 数字 | web 加载完成后，启动屏延迟隐藏的时间（毫秒）；0 表示禁用启动屏 | 3000 |\r\n| ShowSplashScreenSpinner | 布尔值 | 是否显示加载指示器（Spinner） | false |\r\n| SplashMaintainAspectRatio | 布尔值 | 启动屏是否全屏显示 | false |\r\n| SplashScreenSpinnerColor | 字符串 | 加载指示器（Spinner）的颜色，支持十六进制颜色值（如 #ffffff） | #000000 |\r\n| FadeSplashScreenDuration | 数字 | 启动屏消失动画的持续时间（毫秒） | 1000 |\r\n| FullScreenAfterCloseSplash | 布尔值 | 启动屏关闭后，应用是否保持全屏显示 | false |\r\n\r\n### 3. 常见问题（FAQ）\r\n\r\n#### Q1: 启动屏不显示怎么办？\r\n\r\n1. 检查插件是否安装成功：执行 `hcordova plugin list` 确认插件存在于已安装列表中\r\n\r\n2. 核实 config.xml 中参数是否正确：检查配置名称、参数值是否有误，确保无拼写错误\r\n\r\n3. 检查图片资源：确保 resource/media 目录下存在命名正确的图片（splash_portrait、splash_landscape）\r\n\r\n4. 重新构建项目：执行 `hcordova build ohos`，确保插件配置和图片资源正确加载\r\n\r\n#### Q2: 启动屏无法隐藏怎么办？\r\n\r\n1. 检查 AutoHideSplashScreen 配置：若设置为 false，需手动调用 `navigator.splashscreen.hide()` 隐藏\r\n\r\n2. 确认 API 调用时机：确保 API 在 `deviceready` 事件触发后调用\r\n\r\n3. 检查 SplashScreenDelay 配置：若设置为 0，启动屏会直接禁用，不会显示也无需隐藏\r\n\r\n### 4. 注意事项\r\n\r\n- API 调用时机：所有 JavaScript API 必须在 `deviceready` 事件触发后调用，否则会出现 navigator.splashscreen 未定义、调用失败等异常。\r\n\r\n- 配置优先级：config.xml 中的配置直接决定启动屏的表现，参数错误或缺失会导致启动屏异常，建议按示例配置逐步调整。\r\n\r\n- 图片要求：OHOS 平台启动屏图片必须按指定名称（splash_portrait、splash_landscape）和路径（resource/media）放置，否则启动屏无法正常显示。\r\n\r\n- 自动隐藏规则：若设置 `AutoHideSplashScreen=\"false\"`，web 页面加载完毕后启动屏不会自动隐藏，需手动调用 `hide()` 隐藏。\r\n\r\n- 动画效果：淡入淡出动画需配置 `FadeSplashScreenDuration` 参数，否则无动画效果，建议根据应用风格设置合适的动画时长。\r\n\r\n- 兼容性提示：确保 HCordova CLI 版本支持 cordova-ohos/ohos 2.0.0+，否则插件可能无法正常集成和运行。\r\n\r\n## 目录结构\r\n\r\n```\r\ncordova-plugin-splashscreen          # [根目录] 启动屏插件项目根目录\r\n├── src                              # [源码目录] 存放原生平台代码\r\n│   └── main                         # [主目录] 主代码目录\r\n│       └── cpp                      # [C++ 目录] C++ 原生代码目录\r\n│           └── SplashScreen         # [C++ 模块] 启动屏 C++ 模块文件夹\r\n│               ├── SplashScreen.cpp # [C++ 实现] C++ 源文件，实现启动屏的显示/隐藏逻辑\r\n│               └── SplashScreen.h   # [C++ 声明] C++ 头文件，定义启动屏接口\r\n├── www                              # [前端目录] 存放供 Web 端调用的 JS 接口文件\r\n│   └── splashscreen.js              # [JS 文件] 暴露给 Web 端的 JS 接口\r\n├── .gitignore                       # [配置] Git 版本控制忽略文件配置\r\n├── LICENSE                          # [文本] 开源许可证文件\r\n├── OAT.xml                          # [配置] 门禁配置文件\r\n├── package.json                     # [配置] npm 包描述文件，包含版本、依赖等信息\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-splashscreen/issues) ，当然也非常欢迎发 [PR](https://gitcode.com/CPF-Cordova/cordova-plugin-splashscreen/pulls) 共建。\r\n\r\n## 许可证\r\n\r\n本插件基于 **Apache License 2.0** 开源，详见 [LICENSE](LICENSE) 文件。\r\n\r\n## 官方资源\r\n\r\n- Apache Cordova（Android 和 iOS）：[cordova-plugin-splashscreen 官方指南](https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-splashscreen/)\r\n\r\n- GitCode 仓库：[CPF-Cordova/cordova-plugin-splashscreen](https://gitcode.com/CPF-Cordova/cordova-plugin-splashscreen)\r\n","readmeFilename":"README.md"}