React Native 原生开发指南
写在前面
React Native (RN) 是一个用于构建跨平台移动应用的框架。它允许开发者使用 JavaScript 和 React 来编写应用程序,并将其转换为原生代码。虽然 RN 提供了许多内置的组件和 API,但有时候你可能需要访问原生平台的特定功能或性能优化。为此,RN 提供了多种方式来桥接原生平台能力,包括使用 Turbo 模块、C++ 实现跨平台的原生模块、自定义 C++ 类型和 Fabric 原生 UI 组件。
本文将详细介绍这些方法,并提供一些示例代码和实践建议。
桥接原生平台能力
RN 的核心思想是将 JavaScript 代码转换为原生代码。然而,并不是所有的原生功能都可以直接在 JavaScript 中使用。为了解决这个问题,RN 提供了一个桥接机制,允许你在 JavaScript 和原生代码之间传递数据和调用方法。
Native Module
Native Module 是 RN 中最基本的桥接方式。它允许你在原生平台上编写代码,并将其暴露给 JavaScript。要创建一个 Native Module,你需要在原生平台上编写相应的代码,并在 JavaScript 中使用 NativeModules
API 来访问它。
以下是一个简单的示例,演示如何在 iOS 平台上创建一个 Native Module,并在 JavaScript 中使用它:
Objective-C
// MyNativeModule.h
#import <React/RCTBridgeModule.h>
@interface MyNativeModule : NSObject <RCTBridgeModule>
@end
// MyNativeModule.m
#import "MyNativeModule.h"
@implementation MyNativeModule
RCT_EXPORT_MODULE();
- (dispatch_block_t)sayHello:(NSString *)name callback:(RCTResponseSenderBlock)callback {
NSLog(@"Hello, %@", name);
callback(@[@"Hello, ", name]);
return ^{
NSLog(@"Goodbye, %@", name);
};
}
@end
在这个示例中,我们定义了一个名为 MyNativeModule
的 Native Module,它有一个名为 sayHello
的方法,接受一个字符串参数 name
,并在控制台中打印出一条欢迎消息。同时,它还返回一个闭包,用于在调用结束后打印出一条再见消息。
JavaScript
import { NativeModules } from 'react-native';
const { MyNativeModule } = NativeModules;
MyNativeModule.sayHello('John', (result) => {
console.log(result); // 输出:["Hello, ", "John"]
});
在这个示例中,我们首先导入了 NativeModules
API。然后,我们使用 MyNativeModule
对象来调用 sayHello
方法,并传递一个字符串参数 name
和一个回调函数。回调函数将接收到一个数组作为参数,包含了欢迎消息的前缀和 name
的值。
Native UI Component
除了 Native Module,RN 还支持 Native UI Component。Native UI Component 允许你在原生平台上编写自定义的 UI 组件,并将其嵌入到 RN 应用程序中。
以下是一个简单的示例,演示如何在 Android 平台上创建一个 Native UI Component,并在 JavaScript 中使用它:
Java
// MyNativeComponent.java
import com.facebook.react.bridge.ReactContext;
import com.facebook.react.bridge.JSApplication;
import com.facebook.react.uimanager.SimpleViewManager;
import com.facebook.react.uimanager.ThemedReactContext;
import com.facebook.react.uimanager.annotations.ReactProp;
public class MyNativeComponent extends SimpleViewManager<MyNativeView> {
public static final String REACT_CLASS = "MyNativeComponent";
@Override
public String getName() {
return REACT_CLASS;
}
@Override
protected MyNativeView createViewInstance(ThemedReactContext context) {
return new MyNativeView(context);
}
@ReactProp(name = "text")
public void setText(MyNativeView view, String text) {
view.setText(text);
}
}
// MyNativeView.java
import android.content.Context;
import android.widget.TextView;
public class MyNativeView extends TextView {
public MyNativeView(Context context) {
super(context);
}
public void setText(String text) {
super.setText(text);
}
}
在这个示例中,我们定义了一个名为 MyNativeComponent
的 Native UI Component,它有一个名为 text
的属性,用于设置文本内容。同时,我们还定义了一个名为 MyNativeView
的原生视图类,用于显示文本内容。
JavaScript
import React from 'react';
import { View, Text } from 'react-native';
import { MyNativeComponent } from 'react-native';
const App = () => {
return (
<View>
<MyNativeComponent text="Hello, World!" />
</View>
);
};
export default App;
在这个示例中,我们首先导入了 MyNativeComponent
。然后,我们在 App
组件中使用它,并设置了 text
属性的值。
Turbo 模块
Turbo 模块是 RN 中的一种新型的原生模块,它可以在不需要 JavaScript 线程的情况下直接在原生线程上执行代码。这样可以大大提高性能,尤其是在处理大量数据或进行复杂计算时。
以下是一个简单的示例,演示如何在 iOS 平台上创建一个 Turbo 模块,并在 JavaScript 中使用它:
Objective-C
// MyTurboModule.h
#import <React/RCTTurboModule.h>
@interface MyTurboModule : NSObject <RCTTurboModule>
@end
// MyTurboModule.m
#import "MyTurboModule.h"
@implementation MyTurboModule
- (void)add:(double)a b:(double)b resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject {
double result = a + b;
resolve(@[ @(result) ]);
}
@end
在这个示例中,我们定义了一个名为 MyTurboModule
的 Turbo 模块,它有一个名为 add
的方法,接受两个数字参数 a
和 b
,并返回它们的和。
JavaScript
import { NativeModules } from 'react-native';
const { MyTurboModule } = NativeModules;
MyTurboModule.add(1, 2).then((result) => {
console.log(result); // 输出:3
});
在这个示例中,我们首先导入了 NativeModules
API。然后,我们使用 MyTurboModule
对象来调用 add
方法,并传递两个数字参数。由于 add
方法是异步的,我们使用 then
方法来处理结果。
使用 C++ 实现跨平台的原生模块
如果你需要在 RN 应用程序中使用一些高性能的原生库或算法,可能需要使用 C++ 来实现跨平台的原生模块。RN 提供了一个名为 react-native-cxx
的库,用于简化这个过程。
以下是一个简单的示例,演示如何在 RN 应用程序中使用 C++ 实现的原生模块:
C++
// MyNativeModule.h
#include <react-native-cxx/JSI.h>
namespace MyNativeModule {
void install(jsi::Runtime &rt);
}
// MyNativeModule.cpp
#include <react-native-cxx/JSI.h>
#include <iostream>
namespace MyNativeModule {
jsi::Function sayHello(jsi::Runtime &rt) {
return jsi::Function::createFromHostFunction(
rt,
jsi::PropNameID::forAscii(rt, "sayHello"),
1,
[](jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args, size_t count) {
std::string name = args[0].asString(rt).utf8();
std::cout << "Hello, " << name << std::endl;
return jsi::Value::undefined();
}
);
}
void install(jsi::Runtime &rt) {
rt.global().setProperty(rt, jsi::PropNameID::forAscii(rt, "MyNativeModule"), jsi::Object(rt));
rt.global().getProperty(rt, "MyNativeModule").asObject(rt).setProperty(rt, jsi::PropNameID::forAscii(rt, "sayHello"), sayHello(rt));
}
}
在这个示例中,我们定义了一个名为 MyNativeModule
的 C++ 原生模块,它有一个名为 sayHello
的方法,接受一个字符串参数 name
,并在控制台中打印出一条欢迎消息。
JavaScript
import { NativeModules } from 'react-native';
const { MyNativeModule } = NativeModules;
MyNativeModule.sayHello('John');
在这个示例中,我们首先导入了 NativeModules
API。然后,我们使用 MyNativeModule
对象来调用 sayHello
方法,并传递一个字符串参数 name
。
高级:自定义 C++ 类型
在某些情况下,你可能需要在 C++ 原生模块中使用自定义的数据类型。RN 提供了一个名为 react-native-cxx
的库,用于简化这个过程。
以下是一个简单的示例,演示如何在 RN 应用程序中使用自定义的 C++ 类型:
C++
// MyNativeModule.h
#include <react-native-cxx/JSI.h>
namespace MyNativeModule {
class Person {
public:
std::string name;
int age;
Person(std::string name, int age) : name(name), age(age) {}
};
void install(jsi::Runtime &rt);
}
// MyNativeModule.cpp
#include <react-native-cxx/JSI.h>
#include <iostream>
namespace MyNativeModule {
jsi::Function greet(jsi::Runtime &rt) {
return jsi::Function::createFromHostFunction(
rt,
jsi::PropNameID::forAscii(rt, "greet"),
1,
[](jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args, size_t count) {
Person person = args[0].asObject(rt).asHostObject(rt).getHostObject(rt).as<Person>();
std::cout << "Hello, " << person.name << " (" << person.age << ")" << std::endl;
return jsi::Value::undefined();
}
);
}
void install(jsi::Runtime &rt) {
rt.global().setProperty(rt, jsi::PropNameID::forAscii(rt, "MyNativeModule"), jsi::Object(rt));
rt.global().getProperty(rt, "MyNativeModule").asObject(rt).setProperty(rt, jsi::PropNameID::forAscii(rt, "greet"), greet(rt));
}
}
在这个示例中,我们定义了一个名为 Person
的自定义 C++ 类型,并在 greet
方法中使用它。greet
方法接受一个 Person
对象作为参数,并在控制台中打印出一条问候消息。
JavaScript
import { NativeModules } from 'react-native';
const { MyNativeModule } = NativeModules;
const person = {
name: 'John',
age: 30,
};
My
原文地址:https://blog.csdn.net/Ght19970126/article/details/144084903
免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!