react_native_screen_corner_radius:基于 React Native 鸿蒙生态的屏幕圆角适配项目

可帮助开发者获取鸿蒙设备屏幕圆角半径及判断屏幕是否为圆角,是 react-native-screen-corner-radius 的鸿蒙适配版本,支持 API 12+,提供 ScreenCornerRadius 和 IsScreenRounded 接口,单位与 Android 端一致为 px。【此简介由AI生成】

分支3Tags0
当前项目代码仓暂无内容

@bingtang-rn/react-native-screen-corner-radius for HarmonyOS

本项目基于 react-native-screen-corner-radius 开发,为 React Native 鸿蒙(OpenHarmony)适配版本。如果在使用过程中有任何问题,可以在GitCode提Issue,会及时跟进。issue地址:issues

版本对应关系

鸿蒙适配包版本 原始库版本 支持 RN 版本 Autolink 编译 API 版本
见发布记录 0.2.3 0.72+ API17+

安装

npm install @bingtang-rn/react-native-screen-corner-radius

使用

import { ScreenCornerRadius, IsScreenRounded } from 'react-native-screen-corner-radius';

console.log('Corner radius:', ScreenCornerRadius); // e.g. 56 (px)
console.log('Is rounded:', IsScreenRounded);       // true or false

import 时使用原库名 'react-native-screen-corner-radius',而非鸿蒙包名。

平台差异

  • HarmonyOS 上 ScreenCornerRadius 使用 @ohos.display.getRoundedCorner()(API17+),低版本设备返回 0
  • 单位为 px,与 Android 端一致;iOS 端单位为 pts

权限要求

  • 本库不需要任何权限声明
版本 是否支持 Autolink
当前版本

如使用版本支持 Autolink 且工程已接入,可跳过手动配置。

Manual Link 配置

说明:本模块需要同时在 C++ 侧和 ETS 侧注册 Package。

1. Overrides RN SDK

在工程根目录 oh-package.json5 添加:

{
  "overrides": {
    "@rnoh/react-native-openharmony": "./react_native_openharmony"
  }
}

2. 引入原生端依赖

打开 entry/oh-package.json5,添加:

"dependencies": {
  "@bingtang-rn/react-native-screen-corner-radius": "file:../../node_modules/@bingtang-rn/react-native-screen-corner-radius/harmony/screen_corner_radius.har"
}

执行 ohpm install

3. 配置 CMakeLists

打开 entry/src/main/cpp/CMakeLists.txt,添加:

set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules")

add_subdirectory("${OH_MODULES}/@bingtang-rn/react-native-screen-corner-radius/src/main/cpp" ./screen_corner_radius)

target_link_libraries(rnoh_app PUBLIC screen_corner_radius)

4. 注册 Package(C++ 侧)

打开 entry/src/main/cpp/PackageProvider.cpp,添加:

#include "ScreenCornerRadiusPackage.h"

std::vector<std::shared_ptr<Package>> PackageProvider::getPackages(Package::Context ctx) {
    return {
        std::make_shared<ScreenCornerRadiusPackage>(ctx),
    };
}

5. 注册 Package(ETS 侧)

打开 entry/src/main/ets/RNPackagesFactory.ets,添加:

import { ScreenCornerRadiusPackage } from '@bingtang-rn/react-native-screen-corner-radius/ts';

export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
  return [
    new ScreenCornerRadiusPackage(ctx),
  ];
}

属性 / API

API 描述 参数 返回值 HarmonyOS 支持
ScreenCornerRadius 屏幕圆角半径值 number ⚠️ 部分支持(API17+ 设备返回真实值,低版本返回 0)
IsScreenRounded 屏幕是否有圆角 boolean ⚠️ 部分支持(派生自 ScreenCornerRadius,受其限制)

平台差异

  • ScreenCornerRadius:HarmonyOS 使用 display.getDefaultDisplaySync().getRoundedCorner() 获取,API17+ 才可用;Android 使用 RoundedCorner API(API17+);iOS 使用 UIScreen._displayCornerRadius(私有 API)
  • 虚拟屏和未配置圆角的物理屏返回 0

未实现功能

使用限制

  • getRoundedCorner() 需要 API17+,低于此版本的设备调用会抛 801 错误,已通过 try-catch 降级返回 0

快速验证(运行 Example)

前置条件

依赖 版本要求
Node.js >= 18
DevEco Studio 5.0+ / 6.0+
HarmonyOS SDK API 17+

运行步骤

1. 克隆仓库

git clone <仓库地址>
cd <仓库目录>

2. 安装依赖并构建

npm install --legacy-peer-deps
npm pack           # 生成 tgz 包(会自动触发 prepare 构建 JS 产物)

3. 进入 example 目录,安装依赖

cd example
npm install --legacy-peer-deps

4. 生成 JS Bundle

npm run dev

产物:harmony/entry/src/main/resources/rawfile/bundle.harmony.js

5. 用 DevEco Studio 打开鸿蒙工程

  • 打开 DevEco Studio
  • 选择 example/harmony 目录
  • 等待 Sync 完成

6. 编译并运行 HAP

在 DevEco Studio 中点击运行按钮,将 HAP 安装到设备/模拟器。

注意:Example 中已预置插件依赖和 Package 注册,无需手动配置 Link。

约束与限制

兼容性

  • RNOH: 0.72+
  • HarmonyOS SDK: API 17+
  • DevEco Studio: 5.0+

遗留问题

开源协议

本项目基于 MIT,详见 LICENSE 文件。

项目介绍

可帮助开发者获取鸿蒙设备屏幕圆角半径及判断屏幕是否为圆角,是 react-native-screen-corner-radius 的鸿蒙适配版本,支持 API 12+,提供 ScreenCornerRadius 和 IsScreenRounded 接口,单位与 Android 端一致为 px。【此简介由AI生成】

定制我的领域