核心内容摘要
RedisDesktopManager命令行实战：从入门到精通的5个高效技巧
前言react-native-linear-gradient 是一个强大的线性渐变库允许在 React Native 应用中创建美丽的线性渐变效果。
它支持自定义颜色、角度、位置等参数可以用于按钮、背景、卡片等各种场景完全兼容 Android、iOS 和 HarmonyOS 三端。
库简介基本信息库名称: react-native-linear-gradient版本信息:
3.
0: 支持 RN
72 版本react-native-oh-tpl/react-native-linear-gradient
3.
0: 支持 RN
77 版本react-native-ohos/react-native-linear-gradient官方仓库: https://github.com/react-native-oh-library/react-native-linear-gradient主要功能:创建线性渐变效果支持多种颜色和方向支持渐变位置兼容 Android、iOS 和 HarmonyOS兼容性验证:该第三方库的仓库已迁移至 Gitcode且支持直接从 npm 下载新的包名为react-native-ohos/react-native-linear-gradient为什么需要这个库视觉效果: 渐变可以提升应用的视觉效果和用户体验灵活定制: 支持自定义颜色、角度、位置等参数性能优秀: 原生渲染性能优异易于使用: API 简单直观跨平台: 在三端提供一致的渲染效果 安装步骤
使用 npm 安装根据您的 RN 版本选择对应的包名RN
72 版本:npminstallreact-native-oh-tpl/react-native-linear-gradientRN
77 版本:npminstallreact-native-ohos/react-native-linear-gradient
验证安装安装完成后检查package.json文件应该能看到新增的依赖。
根据您的 RN 版本选择对应的库版本RN
72 版本:{dependencies:{react-native-oh-tpl/react-native-linear-gradient:^
3.
0,// ... 其他依赖}}RN
77 版本:{dependencies:{react-native-ohos/react-native-linear-gradient:^
3.
0,// ... 其他依赖}} HarmonyOS 平台配置 ⭐
引入原生端代码目前有两种方法方法一通过 har 包引入推荐[!TIP] har 包位于三方库安装路径的harmony文件夹下。
打开entry/oh-package.json5添加以下依赖RN
72 版本:dependencies: { react-native-oh-tpl/react-native-linear-gradient: file:../../node_modules/react-native-oh-tpl/react-native-linear-gradient/harmony/linear_gradient.har }RN
77 版本:dependencies: { react-native-ohos/react-native-linear-gradient: file:../../node_modules/react-native-ohos/react-native-linear-gradient/harmony/linear_gradient.har }点击右上角的sync按钮或者在终端执行cdentry ohpminstall方法二直接链接源码目前 DevEco Studio 不支持通过源码引入外部 module我们推荐使用直接链接源码的方式将源码通过操作改成 harmony 工程的内部模块。
步骤 1: 把RN工程/node_modules/react-native-ohos/react-native-linear-gradient/harmony目录下的源码linear_gradient复制到harmony鸿蒙壳工程工程根目录下。
步骤 2: 在harmony工程根目录的build-profile.template.json5若存在和build-profile.json5添加以下模块modules: [ ... { name: xxx, srcPath: ./xxx, }, { name: linear_gradient, srcPath: ./linear_gradient, } ]步骤 3: 打开linear_gradient/oh-package.json5修改react-native-openharmony和项目的版本一致。
步骤 4: 打开entry/oh-package.json5添加以下依赖RN
72 版本:dependencies: { rnoh/react-native-openharmony:
0.
7
90, react-native-oh-tpl/react-native-linear-gradient: file:../linear_gradient }RN
77 版本:dependencies: { rnoh/react-native-openharmony:
0.
7
90, react-native-ohos/react-native-linear-gradient: file:../linear_gradient }步骤 5: 点击 DevEco Studio 右上角的sync按钮
配置 CMakeLists 和引入 LinearGradientPackage打开entry/src/main/cpp/CMakeLists.txt添加# RNOH_BEGIN: manual_package_linking_1 add_subdirectory(../../../../linear_gradient/src/main/cpp ./linear-gradient) # RNOH_END: manual_package_linking_1 # RNOH_BEGIN: manual_package_linking_2 target_link_libraries(rnoh_app PUBLIC rnoh_linear_gradient) # RNOH_END: manual_package_linking_2打开entry/src/main/cpp/PackageProvider.cpp添加#include RNOH/PackageProvider.h #include generated/RNOHGeneratedPackage.h #include LinearGradientPackage.h using namespace rnoh; std::vectorstd::shared_ptrPackage PackageProvider::getPackages(Package::Context ctx) { return { std::make_sharedRNOHGeneratedPackage(ctx), std::make_sharedLinearGradientPackage(ctx) }; }重要说明: react-native-linear-gradient 只需要配置 C 部分CMakeLists.txt 和 PackageProvider.cpp不需要在 ArkTs 侧导入 ts 文件因为该库没有提供 ts 文件。
运行点击右上角的sync按钮或者在终端执行cdentry ohpminstall然后编译、运行即可。
完整代码示例下面是一个完整的示例展示了react-native-linear-gradient的各种使用场景importReactfromreact;import{View,Text,StyleSheet,ScrollView,TouchableOpacity,StatusBar}fromreact-native;importLinearGradientfromreact-native-linear-gradient;functionLinearGradientDemo(){return(ScrollView style{styles.container}StatusBar barStylelight-content/{/* 示例 1: 基础渐变 */}View style{styles.section}Text style{styles.sectionTitle}
基础渐变/TextLinearGradient colors{[#4c669f,#3b5998,#192f6a]}style{styles.gradientBox}Text style{styles.text}三色渐变/Text/LinearGradient/View{/* 示例 2: 水平渐变 */}View style{styles.section}Text style{styles.sectionTitle}
水平渐变/TextLinearGradient colors{[#ff7e5f,#feb47b]}startendstyle{styles.gradientBox}Text style{styles.text}水平渐变/Text/LinearGradient/View{/* 示例 3: 垂直渐变 */}View style{styles.section}Text style{styles.sectionTitle}
垂直渐变/TextLinearGradient colors{[#a1c4fd,#c2e9fb]}startendstyle{styles.gradientBox}Text style{styles.text}垂直渐变/Text/LinearGradient/View{/* 示例 4: 对角渐变 */}View style{styles.section}Text style{styles.sectionTitle}
对角渐变/TextLinearGradient colors{[#fa709a,#fee140]}startendstyle{styles.gradientBox}Text style{styles.text}对角渐变/Text/LinearGradient/View{/* 示例 5: 渐变位置 */}View style{styles.section}Text style{styles.sectionTitle}
渐变位置/TextLinearGradient colors{[#667eea,#764ba2,#f093fb]}locations{[0,
5,1]}style{styles.gradientBox}Text style{styles.text}自定义位置/Text/LinearGradient/View{/* 示例 6: 渐变按钮 */}View style{styles.section}Text style{styles.sectionTitle}
渐变按钮/TextTouchableOpacity style{styles.buttonContainer}LinearGradient colors{[#4facfe,#00f2fe]}style{styles.gradientButton}Text style{styles.buttonText}登录/Text/LinearGradient/TouchableOpacityTouchableOpacity style{styles.buttonContainer}LinearGradient colors{[#f093fb,#f5576c]}style{styles.gradientButton}Text style{styles.buttonText}注册/Text/LinearGradient/TouchableOpacity/View{/* 示例 7: 卡片渐变 */}View style{styles.section}Text style{styles.sectionTitle}
卡片渐变/TextLinearGradient colors{[#43e97b,#38f9d7]}style{styles.cardGradient}Text style{styles.cardTitle}精美卡片/TextText style{styles.cardText}使用渐变背景创建精美卡片效果/TextView style{styles.cardActions}TouchableOpacity style{styles.cardButton}Text style{styles.cardButtonText}了解更多/Text/TouchableOpacity/View/LinearGradient/View{/* 示例 8: 圆形渐变 */}View style{styles.section}Text style{styles.sectionTitle}
圆形渐变/TextLinearGradient colors{[#667eea,#764ba2]}style{styles.circleGradient}Text style{styles.circleText}圆形/Text/LinearGradient/View{/* 示例 9: 多色渐变 */}View style{styles.section}Text style{styles.sectionTitle}
多色渐变/TextLinearGradient colors{[#FF512F,#DD2476,#FF512F,#F09819]}startendstyle{styles.gradientBox}Text style{styles.text}多色循环渐变/Text/LinearGradient/View{/* 示例 10: 透明度渐变 */}View style{styles.section}Text style{styles.sectionTitle}
透明度渐变/TextLinearGradient colors{[rgba(255, 0, 0,
0.
,rgba(0, 255, 0,
0.
,rgba(0, 0, 255,
0.
]}style{styles.gradientBox}Text style{styles.text}带透明度的渐变/Text/LinearGradient/View/ScrollView);}conststylesStyleSheet.create({container:{flex:1,backgroundColor:#f5f5f5,},section:{marginBottom:30,},sectionTitle:{fontSize:18,fontWeight:bold,marginBottom:10,marginLeft:15,},gradientBox:{height:120,justifyContent:center,alignItems:center,marginHorizontal:15,borderRadius:10,},text:{color:#ffffff,fontSize:20,fontWeight:bold,textShadowColor:rgba(0, 0, 0,
0.
,textShadowOffset:{width:0,height:2},textShadowRadius:4,},buttonContainer:{marginHorizontal:15,marginBottom:15,},gradientButton:{height:50,justifyContent:center,alignItems:center,borderRadius:25,},buttonText:{color:#ffffff,fontSize:18,fontWeight:bold,},cardGradient:{marginHorizontal:15,padding:20,borderRadius:15,},cardTitle:{color:#ffffff,fontSize:24,fontWeight:bold,marginBottom:10,},cardText:{color:#ffffff,fontSize:16,marginBottom:20,opacity:
9,},cardActions:{flexDirection:row,justifyContent:flex-end,},cardButton:{backgroundColor:rgba(255, 255, 255,
0.
,paddingHorizontal:20,paddingVertical:10,borderRadius:20,},cardButtonText:{color:#ffffff,fontWeight:bold,},circleGradient:{width:120,height:120,borderRadius:60,justifyContent:center,alignItems:center,alignSelf:center,marginHorizontal:15,},circleText:{color:#ffffff,fontSize:18,fontWeight:bold,},});exportdefaultLinearGradientDemo;
执行npm run harmony命令执行npm run harmony命令构建适用于鸿蒙的 bundle 文件并拷贝到鸿蒙工程rawfile目录下。
实际应用场景完整示例代码已展示了以下实际应用场景基础渐变: 使用多种颜色创建基础的线性渐变效果方向控制: 通过start和end属性控制渐变方向水平、垂直、对角位置控制: 使用locations属性自定义颜色的渐变位置渐变按钮: 创建美观的渐变按钮提升用户体验卡片渐变: 为卡片添加渐变背景增强视觉效果圆形渐变: 创建圆形的渐变效果适合头像、图标等场景多色渐变: 使用多种颜色创建复杂的渐变效果透明度渐变: 支持带透明度的颜色创造更丰富的视觉效果⚠️
注意事项与最佳实践
颜色数量至少需要 2 个颜色建议不要超过 5 个颜色以保持简洁
locations 的使用// 正确locations 长度与 colors 长度一致LinearGradient colors{[#red,#blue,#green]}locations{[0,
5,1]}style{style}
性能优化避免在列表中使用过多的渐变对于静态渐变考虑使用图片代替在 ScrollView 中避免大量复杂的渐变
渐变角度// 45度角对角startend// 水平渐变startend// 垂直渐变startend
HarmonyOS 兼容性在 HarmonyOS 上渐变渲染与原生平台保持一致。
圆角处理LinearGradient colors{[#4c669f,#3b5998]}style
与其他组件配合SafeAreaViewLinearGradient colors{[#4c669f,#3b5998]}style{/* 内容 */}/LinearGradient/SafeAreaView
颜色格式支持的颜色格式十六进制‘#FF0000’RGBA‘rgba(255, 0, 0,
0.
’颜色名称‘red’, ‘blue’, ‘green’ 对比静态颜色 vs 线性渐变特性静态颜色线性渐变视觉效果⚠️ 单调✅ 丰富用户体验⚠️ 普通✅ 优秀性能✅ 最佳⚠️ 稍有损耗定制性❌ 有限✅ 灵活适用场景✅ 简单场景✅ 复杂场景
总结通过集成react-native-linear-gradient我们为项目添加了强大的线性渐变功能。
这个库支持多种渐变方向、颜色和位置可以用于按钮、卡片、背景等各种场景大大提升应用的视觉效果。
关键要点回顾✅安装依赖: 根据 RN 版本选择对应的包名RN