Nâng cấp lên phiên bản mới của React Native sẽ cung cấp cho bạn quyền truy cập vào nhiều API, chế độ xem, công cụ dành cho nhà phát triển và các tiện ích khác. Việc nâng cấp yêu cầu một chút nỗ lực nhưng chúng tôi cố gắng giúp bạn dễ dàng hơn. Các hướng dẫn hơi khác một chút tùy thuộc vào việc bạn đã sử dụng create-react-native-app hay react-native init để tạo dự án của mình.
Xem thêm tại:
Xác định platform, framework và Tool
Tạo các dự án React Native App
Nâng cấp dự án Create React Native App của bạn lên phiên bản React Native mới yêu cầu cập nhật phiên react-native bản gói react và trong tệp của bạn. Vui lòng tham khảo tài liệu này để biết những phiên bản nào được hỗ trợ. Bạn cũng sẽ cần đặt chính xác trong tệp của mình.expopackage.jsonsdkVersionapp.json
Các dự án được xây dựng bằng mã gốc
Dự án chỉ có mã gốc
Phần này chỉ áp dụng cho các dự án được thực hiện bằng react-native init hoặc cho những dự án được thực hiện bằng Create React Native App đã bị loại bỏ. Để biết thêm thông tin về việc loại bỏ, vui lòng xem hướng dẫn trên kho lưu trữ Tạo ứng dụng gốc của React.
Vì các dự án React Native được xây dựng bằng mã gốc về cơ bản được tạo thành từ một dự án Android, một dự án iOS và một dự án JavaScript, nên việc nâng cấp có thể khá phức tạp. Đây là những gì bạn cần làm để nâng cấp từ phiên bản React Native cũ hơn.
Nâng cấp dựa trên Git
Mô-đun react-native-git-upgrade cung cấp thao tác một bước để nâng cấp tệp nguồn với mức tối thiểu xung đột. Dưới mui xe, nó bao gồm 2 giai đoạn:
Đầu tiên, nó tính một bản vá Git giữa cả tệp mẫu cũ và mới,
Sau đó, bản vá được áp dụng trên các nguồn của người dùng.
QUAN TRỌNG: Bạn không phải cài đặt phiên bản mới của react-native gói, nó sẽ được cài đặt tự động.
1. Cài đặt Git
Mặc dù dự án của bạn không phải được xử lý bởi hệ thống lập phiên bản Git - bạn có thể sử dụng Mercurial, SVN hoặc không cần gì cả - bạn vẫn cần cài đặt Git trên hệ thống của mình để sử dụng react-native-git-upgrade. Git cũng sẽ cần phải có sẵn trong PATH.
2. Cài đặt react-native-git-upgrade mô-đun
Mô react-native-git-upgrade-đun cung cấp CLI và phải được cài đặt trên toàn cầu:
$ npm install -g react-native-git-upgrade
3. Chạy lệnh
Chạy lệnh sau để bắt đầu quá trình nâng cấp lên phiên bản mới nhất:
$ react-native-git-upgrade
Bạn có thể chỉ định phiên bản React Native bằng cách chuyển đối số:react-native-git-upgrade X.Y
Các mẫu được nâng cấp theo cách tối ưu hóa. Bạn vẫn có thể gặp phải xung đột nhưng chỉ khi hợp nhất 3 chiều Git không thành công, tùy thuộc vào phiên bản và cách bạn sửa đổi nguồn của mình.
4. Giải quyết các xung đột
Các tệp xung đột bao gồm các dấu phân cách làm cho rất rõ ràng các thay đổi đến từ đâu.
Ví dụ:
13B07F951A680F5B00A75B9A /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
<<<<<<< ours
CODE_SIGN_IDENTITY = "iPhone Developer";
FRAMEWORK_SEARCH_PATHS = (
"$(inherited)",
"$(PROJECT_DIR)/HockeySDK.embeddedframework",
"$(PROJECT_DIR)/HockeySDK-iOS/HockeySDK.embeddedframework",
);
=======
CURRENT_PROJECT_VERSION = 1;
>>>>>>> theirs
HEADER_SEARCH_PATHS = (
"$(inherited)",
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include,
"$(SRCROOT)/../node_modules/react-native/React/**",
"$(SRCROOT)/../node_modules/react-native-code-push/ios/CodePush/**",
);
Bạn có thể coi "của chúng tôi" là "nhóm của bạn" và "của họ" là "nhóm nhà phát triển React Native".
Thay thế
Chỉ sử dụng điều này trong trường hợp ở trên không hoạt động.
1. Nâng cấp phần react-native phụ thuộc
Lưu ý phiên bản mới nhất của react-native gói npm từ đây (hoặc sử dụng npm info react-native để kiểm tra).
Bây giờ hãy cài đặt phiên bản đó react-native trong dự án của bạn với npm install --save:
$ npm install --save react-native@X.Y
# where X.Y is the semantic version you are upgrading to
npm WARN peerDependencies The peer dependency react@~R included from react-native...
Nếu bạn thấy cảnh báo về peerDependency, hãy nâng cấp react bằng cách chạy:
$ npm install --save react@R
# where R is the new version of react from the peerDependency warning you saw
2. Nâng cấp các mẫu dự án của bạn
Gói npm mới có thể chứa các bản cập nhật cho các tệp thường được tạo khi bạn chạy react-native init, như các dự án con iOS và Android.
Bạn có thể tham khảo rn-diff để xem có thay đổi nào trong tệp mẫu dự án hay không. Trong trường hợp không có bất kỳ, chỉ cần xây dựng lại dự án và tiếp tục phát triển. Trong trường hợp có những thay đổi nhỏ, bạn có thể cập nhật dự án của mình theo cách thủ công và xây dựng lại.
Nếu có những thay đổi lớn, hãy chạy điều này trong một thiết bị đầu cuối để nhận được những điều sau:
$ react-native upgrade
Thao tác này sẽ kiểm tra tệp của bạn so với mẫu mới nhất và thực hiện như sau:
Nếu có một tệp mới trong mẫu, nó chỉ được tạo.
Nếu một tệp trong mẫu giống hệt với tệp của bạn, tệp đó sẽ bị bỏ qua.
Nếu một tệp trong dự án của bạn khác với mẫu, bạn sẽ được nhắc; bạn có các tùy chọn để giữ tệp của mình hoặc ghi đè tệp đó bằng phiên bản mẫu.
Nâng cấp thủ công
Một số nâng cấp yêu cầu các bước thủ công, ví dụ: 0,13 đến 0,14 hoặc 0,28 đến 0,29. Đảm bảo kiểm tra các ghi chú phát hành khi nâng cấp để bạn có thể xác định bất kỳ thay đổi thủ công nào mà dự án cụ thể của bạn có thể yêu cầu.
Mong rằng những hướng dẫn thao tác kỹ lưỡng từ Mắt Bão sẽ giúp bạn hiểu được react native là gì và bạn cũng có thể thao tác dễ dàng
0 Nhận xét