Triển khai hàng đợi trong javascript

Mô-đun gốc và Thành phần gốc là các công nghệ ổn định của chúng tôi được sử dụng bởi kiến ​​trúc cũ. Chúng sẽ không còn được dùng nữa trong tương lai khi Kiến trúc mới ổn định. Kiến trúc mới sử dụng Mô-đun gốc Turbo và Cấu phần gốc vải để đạt được kết quả tương tự

Chào mừng bạn đến với Mô-đun bản địa dành cho iOS. Vui lòng bắt đầu bằng cách đọc Phần giới thiệu mô-đun gốc để biết phần giới thiệu về mô-đun gốc là gì

Tạo một mô-đun gốc lịch

Trong hướng dẫn sau đây, bạn sẽ tạo một mô-đun gốc,

const {CalendarModuleFoo} = ReactNative.NativeModules;

const {CalendarModuleFoo} = ReactNative.NativeModules;

Cài đặt

Để bắt đầu, hãy mở dự án iOS trong ứng dụng React Native của bạn trong Xcode. Bạn có thể tìm thấy dự án iOS của mình tại đây trong ứng dụng React Native

Chúng tôi khuyên bạn nên sử dụng Xcode để viết mã gốc của mình. Xcode được xây dựng để phát triển iOS và việc sử dụng nó sẽ giúp bạn nhanh chóng giải quyết các lỗi nhỏ hơn như cú pháp mã

Tạo tệp mô-đun gốc tùy chỉnh

Bước đầu tiên là tạo các tệp triển khai và tiêu đề mô-đun gốc tùy chỉnh chính của chúng tôi. Tạo một tệp mới có tên là

const {CalendarModuleFoo} = ReactNative.NativeModules;

và thêm phần sau vào nó

//  RCTCalendarModule.h
#import <React/RCTBridgeModule.h>
@interface RCTCalendarModule : NSObject <RCTBridgeModule>
@end

Bạn có thể sử dụng bất kỳ tên nào phù hợp với mô-đun gốc mà bạn đang xây dựng. Đặt tên cho lớp là

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

Như bạn có thể thấy bên dưới, lớp CalendarModule triển khai giao thức

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

Tiếp theo, hãy bắt đầu triển khai mô-đun gốc. Tạo tệp triển khai tương ứng,

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

________số 8_______

Tên mô-đun

Hiện tại, mô-đun gốc

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

Đối số này không phải là một chuỗi ký tự. Trong ví dụ dưới đây,

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

// To export a module named CalendarModuleFoo
RCT_EXPORT_MODULE(CalendarModuleFoo);

Sau đó, mô-đun gốc có thể được truy cập trong JS như thế này

const {CalendarModuleFoo} = ReactNative.NativeModules;

Nếu bạn không chỉ định tên, tên mô-đun JavaScript sẽ khớp với tên lớp Objective-C, với mọi tiền tố "RCT" hoặc "RK" bị xóa

Hãy làm theo ví dụ dưới đây và gọi

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

const {CalendarModuleFoo} = ReactNative.NativeModules;

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

Sau đó, mô-đun gốc có thể được truy cập trong JS như thế này

const {CalendarModule} = ReactNative.NativeModules;

Xuất phương thức gốc sang JavaScript

React Native sẽ không hiển thị bất kỳ phương thức nào trong mô-đun gốc cho JavaScript trừ khi được thông báo rõ ràng với. Điều này có thể được thực hiện bằng cách sử dụng macro

const {CalendarModule} = ReactNative.NativeModules;

const {CalendarModule} = ReactNative.NativeModules;

const {CalendarModule} = ReactNative.NativeModules;

const {CalendarModuleFoo} = ReactNative.NativeModules;

const {CalendarModule} = ReactNative.NativeModules;

const {CalendarModule} = ReactNative.NativeModules;

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

Xin lưu ý rằng macro

const {CalendarModule} = ReactNative.NativeModules;

1 sẽ không cần thiết với TurboModules trừ khi phương pháp của bạn dựa trên chuyển đổi đối số RCT (xem các loại đối số bên dưới). Cuối cùng, React Native sẽ loại bỏ

const {CalendarModule} = ReactNative.NativeModules;

8, vì vậy chúng tôi không khuyến khích mọi người sử dụng

const {CalendarModule} = ReactNative.NativeModules;

9. Thay vào đó, bạn có thể thực hiện chuyển đổi đối số trong nội dung phương thức

Trước khi bạn xây dựng chức năng của phương thức

const {CalendarModule} = ReactNative.NativeModules;

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

#import <React/RCTLog.h>
RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
 RCTLogInfo(@"Pretending to create an event %@ at %@", name, location);
}

Phương thức đồng bộ

Bạn có thể sử dụng

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getName)
{
return [[UIDevice currentDevice] name];
}

Kiểu trả về của phương thức này phải thuộc kiểu đối tượng (id) và phải được tuần tự hóa thành JSON. Điều này có nghĩa là hook chỉ có thể trả về các giá trị nil hoặc JSON (e. g. NSNumber, NSString, NSArray, NSDictionary)

Hiện tại, chúng tôi không khuyên bạn nên sử dụng các phương thức đồng bộ, vì việc gọi các phương thức đồng bộ có thể có các hình phạt hiệu suất mạnh và gây ra các lỗi liên quan đến luồng cho các mô-đun gốc của bạn. Ngoài ra, xin lưu ý rằng nếu bạn chọn sử dụng

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

Kiểm tra những gì bạn đã xây dựng

Tại thời điểm này, bạn đã thiết lập giàn giáo cơ bản cho mô-đun gốc của mình trong iOS. Kiểm tra điều đó bằng cách truy cập mô-đun gốc và gọi phương thức đã xuất của nó trong JavaScript

Tìm một vị trí trong ứng dụng của bạn mà bạn muốn thêm lệnh gọi vào phương thức

const {CalendarModule} = ReactNative.NativeModules;

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

import React from 'react';
import {NativeModules, Button} from 'react-native';

const NewModuleButton = () => {
  const onPress = () => {
    console.log('We will invoke the native module here!');
  };

  return (
    <Button
      title="Click to invoke your native module!"
      color="#841584"
      onPress={onPress}
    />
  );
};

export default NewModuleButton;

Để truy cập mô-đun gốc của bạn từ JavaScript, trước tiên bạn cần nhập

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Sau đó, bạn có thể truy cập mô-đun gốc

const {CalendarModuleFoo} = ReactNative.NativeModules;

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Bây giờ bạn đã có sẵn mô-đun gốc CalendarModule, bạn có thể gọi phương thức gốc của mình

const {CalendarModule} = ReactNative.NativeModules;

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Bước cuối cùng là xây dựng lại ứng dụng React Native để bạn có thể có mã gốc mới nhất (với mô-đun gốc mới của bạn. ) có sẵn. Trong dòng lệnh của bạn, nơi đặt ứng dụng gốc phản ứng, hãy chạy như sau

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Xây dựng khi bạn lặp lại

Khi bạn làm việc thông qua các hướng dẫn này và lặp lại trên mô-đun gốc của mình, bạn sẽ cần thực hiện xây dựng lại ứng dụng gốc của mình để truy cập các thay đổi gần đây nhất của bạn từ JavaScript. Điều này là do mã mà bạn đang viết nằm trong phần gốc của ứng dụng của bạn. Mặc dù gói metro của React Native có thể theo dõi các thay đổi trong JavaScript và xây dựng lại gói JS một cách nhanh chóng cho bạn, nhưng nó sẽ không làm như vậy đối với mã gốc. Vì vậy, nếu bạn muốn kiểm tra các thay đổi gốc mới nhất của mình, bạn cần xây dựng lại bằng cách sử dụng lệnh

#import <React/RCTLog.h>
RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
 RCTLogInfo(@"Pretending to create an event %@ at %@", name, location);
}

Tóm tắt✨

Bây giờ bạn có thể gọi phương thức

const {CalendarModule} = ReactNative.NativeModules;

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

#import <React/RCTLog.h>
RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
 RCTLogInfo(@"Pretending to create an event %@ at %@", name, location);
}

Tại thời điểm này, bạn đã tạo một mô-đun gốc iOS và gọi một phương thức trên mô-đun đó từ JavaScript trong ứng dụng React Native của bạn. Bạn có thể đọc tiếp để tìm hiểu thêm về những thứ như loại đối số mà phương thức mô-đun gốc của bạn sử dụng và cách thiết lập các cuộc gọi lại và lời hứa trong mô-đun gốc của bạn

Ngoài một mô-đun gốc lịch

Xuất mô-đun gốc tốt hơn

Nhập mô-đun gốc của bạn bằng cách kéo nó ra khỏi

RCT_EXPORT_METHOD(createCalendarEvent:(NSString *)name location:(NSString *)location)
{
}

Để giúp người tiêu dùng mô-đun gốc của bạn không phải làm điều đó mỗi khi họ muốn truy cập mô-đun gốc của bạn, bạn có thể tạo trình bao bọc JavaScript cho mô-đun. Tạo một tệp JavaScript mới có tên là NativeCalendarModule. js với nội dung sau

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Tệp JavaScript này cũng trở thành một vị trí tốt để bạn thêm bất kỳ chức năng phụ nào của JavaScript. Ví dụ: nếu bạn sử dụng hệ thống kiểu như TypeScript, bạn có thể thêm chú thích kiểu cho mô-đun gốc của mình tại đây. Mặc dù React Native chưa hỗ trợ an toàn kiểu Native to JS, nhưng với các chú thích kiểu này, tất cả mã JS của bạn sẽ an toàn kiểu. Các chú thích này cũng sẽ giúp bạn dễ dàng chuyển sang các mô-đun gốc an toàn loại hơn. Dưới đây là một ví dụ về việc thêm loại an toàn vào Mô-đun Lịch

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Trong các tệp JavaScript khác của bạn, bạn có thể truy cập mô-đun gốc và gọi phương thức của nó như thế này

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Lưu ý điều này giả định rằng địa điểm bạn đang nhập

const {CalendarModuleFoo} = ReactNative.NativeModules;

7 nằm trong cùng hệ thống phân cấp với

RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getName)
{
return [[UIDevice currentDevice] name];
}

0. Vui lòng cập nhật nhập tương đối khi cần thiết

Các loại đối số

Khi một phương thức mô-đun gốc được gọi trong JavaScript, React Native sẽ chuyển đổi các đối số từ các đối tượng JS thành các đối tượng tương tự đối tượng Objective-C/Swift của chúng. Vì vậy, ví dụ: nếu phương thức Mô-đun gốc Objective-C của bạn chấp nhận NSNumber, thì trong JS, bạn cần gọi phương thức đó bằng một số. React Native sẽ xử lý chuyển đổi cho bạn. Dưới đây là danh sách các loại đối số được hỗ trợ cho các phương thức mô-đun gốc và các JavaScript tương đương mà chúng ánh xạ tới

Các loại sau hiện được hỗ trợ nhưng sẽ không được hỗ trợ trong TurboModules. Vui lòng tránh sử dụng chúng

• Chức năng (lỗi) -> RCTResponseErrorBlock
• Số -> NSInteger
• Số -> CGFoat
• Số -> nổi

Đối với iOS, bạn cũng có thể viết các phương thức mô-đun gốc với bất kỳ loại đối số nào được lớp

const {CalendarModule} = ReactNative.NativeModules;

Xuất hằng số

Một mô-đun gốc có thể xuất các hằng số bằng cách ghi đè phương thức gốc

RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getName)
{
return [[UIDevice currentDevice] name];
}

RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getName)
{
return [[UIDevice currentDevice] name];
}

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Sau đó, hằng số có thể được truy cập bằng cách gọi

RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getName)
{
return [[UIDevice currentDevice] name];
}

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Về mặt kỹ thuật, có thể truy cập các hằng số được xuất trong

RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getName)
{
return [[UIDevice currentDevice] name];
}

RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getName)
{
return [[UIDevice currentDevice] name];
}

Lưu ý rằng các hằng số chỉ được xuất vào thời điểm khởi tạo, vì vậy nếu bạn thay đổi giá trị

RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getName)
{
return [[UIDevice currentDevice] name];
}

2 trong thời gian chạy thì điều đó sẽ không ảnh hưởng đến môi trường JavaScript

Đối với iOS, nếu bạn ghi đè

RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getName)
{
return [[UIDevice currentDevice] name];
}

RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getName)
{
return [[UIDevice currentDevice] name];
}

import React from 'react';
import {NativeModules, Button} from 'react-native';

const NewModuleButton = () => {
  const onPress = () => {
    console.log('We will invoke the native module here!');
  };

  return (
    <Button
      title="Click to invoke your native module!"
      color="#841584"
      onPress={onPress}
    />
  );
};

export default NewModuleButton;

RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getName)
{
return [[UIDevice currentDevice] name];
}

gọi lại

Các mô-đun gốc cũng hỗ trợ một loại đối số duy nhất - gọi lại. Gọi lại được sử dụng để truyền dữ liệu từ Objective-C sang JavaScript cho các phương thức không đồng bộ. Chúng cũng có thể được sử dụng để thực thi JS không đồng bộ từ phía gốc

Đối với iOS, các cuộc gọi lại được triển khai bằng cách sử dụng loại

import React from 'react';
import {NativeModules, Button} from 'react-native';

const NewModuleButton = () => {
  const onPress = () => {
    console.log('We will invoke the native module here!');
  };

  return (
    <Button
      title="Click to invoke your native module!"
      color="#841584"
      onPress={onPress}
    />
  );
};

export default NewModuleButton;

import React from 'react';
import {NativeModules, Button} from 'react-native';

const NewModuleButton = () => {
  const onPress = () => {
    console.log('We will invoke the native module here!');
  };

  return (
    <Button
      title="Click to invoke your native module!"
      color="#841584"
      onPress={onPress}
    />
  );
};

export default NewModuleButton;

import React from 'react';
import {NativeModules, Button} from 'react-native';

const NewModuleButton = () => {
  const onPress = () => {
    console.log('We will invoke the native module here!');
  };

  return (
    <Button
      title="Click to invoke your native module!"
      color="#841584"
      onPress={onPress}
    />
  );
};

export default NewModuleButton;

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Sau đó, bạn có thể gọi hàm gọi lại trong hàm gốc của mình, cung cấp bất kỳ kết quả nào bạn muốn chuyển đến JavaScript trong một mảng. Lưu ý rằng

import React from 'react';
import {NativeModules, Button} from 'react-native';

const NewModuleButton = () => {
  const onPress = () => {
    console.log('We will invoke the native module here!');
  };

  return (
    <Button
      title="Click to invoke your native module!"
      color="#841584"
      onPress={onPress}
    />
  );
};

export default NewModuleButton;

Điều quan trọng cần làm nổi bật là hàm gọi lại không được gọi ngay sau khi chức năng gốc hoàn thành—hãy nhớ rằng giao tiếp không đồng bộ

// To export a module named CalendarModuleFoo
RCT_EXPORT_MODULE(CalendarModuleFoo);

Phương pháp này sau đó có thể được truy cập trong JavaScript bằng cách sử dụng như sau

// To export a module named CalendarModuleFoo
RCT_EXPORT_MODULE(CalendarModuleFoo);

Một mô-đun gốc được cho là chỉ gọi lại cuộc gọi của nó một lần. Tuy nhiên, nó có thể lưu trữ cuộc gọi lại và gọi nó sau. Mẫu này thường được sử dụng để bọc các API iOS yêu cầu đại biểu— xem ví dụ về

import React from 'react';
import {NativeModules, Button} from 'react-native';

const NewModuleButton = () => {
  const onPress = () => {
    console.log('We will invoke the native module here!');
  };

  return (
    <Button
      title="Click to invoke your native module!"
      color="#841584"
      onPress={onPress}
    />
  );
};

export default NewModuleButton;

Có hai cách tiếp cận để xử lý lỗi với các cuộc gọi lại. Đầu tiên là tuân theo quy ước của Node và coi đối số đầu tiên được chuyển đến mảng gọi lại là một đối tượng lỗi

// To export a module named CalendarModuleFoo
RCT_EXPORT_MODULE(CalendarModuleFoo);

Trong JavaScript, sau đó bạn có thể kiểm tra đối số đầu tiên để xem có lỗi nào được thông qua hay không

// To export a module named CalendarModuleFoo
RCT_EXPORT_MODULE(CalendarModuleFoo);

Một tùy chọn khác là sử dụng hai cuộc gọi lại riêng biệt. onFailure và onSuccess

// To export a module named CalendarModuleFoo
RCT_EXPORT_MODULE(CalendarModuleFoo);

Sau đó, trong JavaScript, bạn có thể thêm một cuộc gọi lại riêng cho các phản hồi lỗi và thành công

// To export a module named CalendarModuleFoo
RCT_EXPORT_MODULE(CalendarModuleFoo);

Nếu bạn muốn chuyển các đối tượng giống như lỗi sang JavaScript, hãy sử dụng

import React from 'react';
import {NativeModules, Button} from 'react-native';

const NewModuleButton = () => {
  const onPress = () => {
    console.log('We will invoke the native module here!');
  };

  return (
    <Button
      title="Click to invoke your native module!"
      color="#841584"
      onPress={onPress}
    />
  );
};

export default NewModuleButton;

import React from 'react';
import {NativeModules, Button} from 'react-native';

const NewModuleButton = () => {
  const onPress = () => {
    console.log('We will invoke the native module here!');
  };

  return (
    <Button
      title="Click to invoke your native module!"
      color="#841584"
      onPress={onPress}
    />
  );
};

export default NewModuleButton;

import React from 'react';
import {NativeModules, Button} from 'react-native';

const NewModuleButton = () => {
  const onPress = () => {
    console.log('We will invoke the native module here!');
  };

  return (
    <Button
      title="Click to invoke your native module!"
      color="#841584"
      onPress={onPress}
    />
  );
};

export default NewModuleButton;

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

lời hứa

Các mô-đun gốc cũng có thể thực hiện một lời hứa, điều này có thể đơn giản hóa JavaScript của bạn, đặc biệt là khi sử dụng cú pháp

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Tái cấu trúc đoạn mã trên để sử dụng lời hứa thay vì gọi lại trông như thế này

// To export a module named CalendarModuleFoo
RCT_EXPORT_MODULE(CalendarModuleFoo);

Bản sao JavaScript của phương thức này trả về một Lời hứa. Điều này có nghĩa là bạn có thể sử dụng từ khóa

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// To export a module named CalendarModuleFoo
RCT_EXPORT_MODULE(CalendarModuleFoo);

Gửi sự kiện tới JavaScript

Các mô-đun gốc có thể báo hiệu các sự kiện tới JavaScript mà không cần gọi trực tiếp. Ví dụ: bạn có thể muốn báo hiệu cho JavaScript lời nhắc rằng một sự kiện lịch từ ứng dụng lịch iOS gốc sẽ sớm diễn ra. Cách ưa thích để thực hiện việc này là phân lớp

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Cập nhật lớp tiêu đề của bạn để nhập

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// To export a module named CalendarModuleFoo
RCT_EXPORT_MODULE(CalendarModuleFoo);

Mã JavaScript có thể đăng ký các sự kiện này bằng cách tạo một phiên bản

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

Bạn sẽ nhận được cảnh báo nếu bạn sử dụng tài nguyên một cách không cần thiết bằng cách phát ra một sự kiện trong khi không có người nghe. Để tránh điều này và để tối ưu hóa khối lượng công việc của mô-đun của bạn (e. g. bằng cách hủy đăng ký nhận thông báo ngược dòng hoặc tạm dừng tác vụ nền), bạn có thể ghi đè

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// To export a module named CalendarModuleFoo
RCT_EXPORT_MODULE(CalendarModuleFoo);

xâu chuỗi

Trừ khi mô-đun gốc cung cấp hàng đợi phương thức của riêng nó, nó không nên đưa ra bất kỳ giả định nào về luồng mà nó đang được gọi. Hiện tại, nếu một mô-đun gốc không cung cấp hàng đợi phương thức, React Native sẽ tạo một hàng đợi GCD riêng cho nó và gọi các phương thức của nó ở đó. Xin lưu ý rằng đây là chi tiết triển khai và có thể thay đổi. Nếu bạn muốn cung cấp rõ ràng hàng đợi phương thức cho mô-đun gốc, hãy ghi đè phương thức

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

const {CalendarModuleFoo} = ReactNative.NativeModules;

Tương tự, nếu một hoạt động có thể mất nhiều thời gian để hoàn thành, mô-đun gốc có thể chỉ định hàng đợi của chính nó để chạy các hoạt động trên. Xin nhắc lại, hiện tại React Native sẽ cung cấp một hàng đợi phương thức riêng cho mô-đun gốc của bạn, nhưng đây là chi tiết triển khai mà bạn không nên dựa vào. Nếu bạn không cung cấp hàng đợi phương thức của riêng mình, thì trong tương lai, các hoạt động chạy dài của mô-đun gốc của bạn có thể sẽ chặn các lệnh gọi không đồng bộ đang được thực thi trên các mô-đun gốc không liên quan khác. Ví dụ, mô-đun

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

const {CalendarModuleFoo} = ReactNative.NativeModules;

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

const {CalendarModuleFoo} = ReactNative.NativeModules;

Chia sẻ hàng đợi công văn giữa các mô-đun

Phương thức

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

16 sẽ được gọi một lần khi mô-đun được khởi tạo và sau đó được React Native giữ lại, vì vậy bạn không cần phải tự mình giữ tham chiếu đến hàng đợi, trừ khi bạn muốn sử dụng nó trong mô-đun của mình. Tuy nhiên, nếu bạn muốn chia sẻ cùng một hàng đợi giữa nhiều mô-đun thì bạn cần đảm bảo rằng bạn giữ lại và trả về cùng một phiên bản hàng đợi cho mỗi mô-đun

Tiêm phụ thuộc

React Native sẽ tự động tạo và khởi tạo mọi mô-đun gốc đã đăng ký. Tuy nhiên, bạn có thể muốn tạo và khởi tạo các phiên bản mô-đun của riêng mình, chẳng hạn như, đưa vào các phụ thuộc

Bạn có thể làm điều này bằng cách tạo một lớp triển khai Giao thức

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

const {CalendarModuleFoo} = ReactNative.NativeModules;

Xuất Swift

Swift không hỗ trợ macro, do đó, việc hiển thị các mô-đun gốc và phương thức của chúng cho JavaScript bên trong React Native yêu cầu thiết lập nhiều hơn một chút. Tuy nhiên, nó hoạt động tương đối giống nhau. Giả sử bạn có cùng một

const {CalendarModuleFoo} = ReactNative.NativeModules;

const {CalendarModuleFoo} = ReactNative.NativeModules;

Điều quan trọng là sử dụng công cụ sửa đổi

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

23 để đảm bảo lớp và chức năng được xuất đúng sang thời gian chạy Objective-C

Sau đó, tạo một tệp triển khai riêng sẽ đăng ký thông tin cần thiết với React Native

const {CalendarModuleFoo} = ReactNative.NativeModules;

Đối với những người mới làm quen với Swift và Objective-C, bất cứ khi nào bạn kết hợp hai ngôn ngữ này trong một dự án iOS, bạn cũng sẽ cần một tệp bắc cầu bổ sung, được gọi là tiêu đề bắc cầu, để hiển thị các tệp Objective-C cho Swift. Xcode sẽ đề nghị tạo tệp tiêu đề này cho bạn nếu bạn thêm tệp Swift vào ứng dụng của mình thông qua tùy chọn menu Xcode

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

const {CalendarModuleFoo} = ReactNative.NativeModules;

Bạn cũng có thể sử dụng

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end

// Without passing in a name this will export the native module name as the Objective-C class name with “RCT” removed
RCT_EXPORT_MODULE();

Quan trọng khi tạo mô-đun bên thứ ba. Thư viện tĩnh với Swift chỉ được hỗ trợ trong Xcode 9 trở lên. Để xây dựng dự án Xcode khi bạn sử dụng Swift trong thư viện tĩnh iOS mà bạn đưa vào mô-đun, dự án ứng dụng chính của bạn phải chứa mã Swift và chính tiêu đề cầu nối. Nếu dự án ứng dụng của bạn không chứa bất kỳ mã Swift nào, giải pháp thay thế có thể là một mã trống. tệp nhanh chóng và một tiêu đề bắc cầu trống

Tên phương thức dành riêng

làm mất hiệu lực()

Các mô-đun gốc có thể tuân thủ giao thức RCTInvalidating trên iOS bằng cách triển khai phương thức

// RCTCalendarModule.m
#import "RCTCalendarModule.h"

@implementation RCTCalendarModule

// To export a module named RCTCalendarModule
RCT_EXPORT_MODULE();

@end