iOS--React Native瀏覽器插件

一:介紹

React Native (簡稱RN)是Facebook於2015年4月開源的跨平臺移動應用開發框架,是Facebook早先開源的JS框架 React 在原生移動應用平臺的衍生產物,目前支持iOS和安卓兩大平臺。RN使用Javascript語言,類似於HTML的JSX,以及CSS來開發移動應用,因此熟悉Web前端開發的技術人員只需很少的學習就可以進入移動應用開發領域。

在React Native移動平臺項目開發中,除了React Native 提供的封裝好的部分插件和原聲組建外,在實際的項目中還需要使用到很多其他的插件,比如網絡請求、數據庫、相機、相冊、通訊錄、視頻播放器、瀏覽器、藍牙連接、圖片處理、消息推送、地圖、統計、埋點等等APP開發中需要用到的功能,都爲IDE開發平臺提供封裝好的插件,以便項目開發使用。

另外,這些博文都是來源於我日常開發中的技術總結,在時間允許的情況下,我會針對技術點分別分享iOS、Android兩個版本,如果有其他技術點需要,可在文章後留言,我會盡全力幫助大家。這篇文章重點介紹原生瀏覽器插件的開發與使用

二:實現思路分析

原生瀏覽器插件是需要實現打開默認瀏覽器和打開自定義瀏覽器,具體的實現思路如下:

  1. 新建WebviewManager類,實現自定義瀏覽器

  2. 新建Webview類,實現RCTBridgeModule協議

  3. 添加RCT_EXPORT_MODULE()宏

  4. 添加React Native跟控制器

  5. 聲明被JavaScript 調用的方法

  6. URL規範檢測

  7. 根據傳參打開瀏覽器

  8. Javascript調用瀏覽器方法

三:實現源碼分析

1. 新建WebviewManager類,實現自定義瀏覽器

新建繼承UIViewController的WebviewManager類,並在.h聲明webURL變量

//WebviewManager.h
#import <UIKit/UIKit.h>
@interface WebviewManager : UIViewController
@property(nonatomic,strong)NSString *webURL;
@end

通過webURL調用NSURLRequest 封裝的requestWithURL方法打開瀏覽器,並在視圖中顯示,代碼如下:

//WebviewManager.m
#import "WebviewManager.h"
#import<WebKit/WebKit.h>
@interface WebviewManager ()
@property(nonatomic,strong)WKWebView *webView;
@end
@implementation WebviewManager
- (void)viewDidLoad {
    [super viewDidLoad];
    self.view.backgroundColor = [UIColor whiteColor];
    UIButton *btn = [UIButton buttonWithType:UIButtonTypeCustom];
    btn.frame = CGRectMake(20, 30, 40, 24);
    [btn setTitle:@"返回" forState:UIControlStateNormal];
    [btn addTarget:self action:@selector(backAction)
              forControlEvents:UIControlEventTouchUpInside];
    btn.titleLabel.font = [UIFont systemFontOfSize:15];
    [btn setTitleColor:[UIColor blackColor]  forState:UIControlStateNormal];
    [self.view addSubview:btn];
    self.webView = [[WKWebView alloc]initWithFrame:CGRectMake(0, 64, [[UIScreen mainScreen]bounds].size.width, [[UIScreen mainScreen]bounds].size.height-64)];
    [self.view addSubview:self.webView];
    [self.webView loadRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:self.webURL]]];   
}
- (void)backAction{
    [self dismissViewControllerAnimated:YES completion:nil];
}
@end
2. 新建Webview類,實現RCTBridgeModule協議

新建繼承NSObject的Webview類,並實現RCTBridgeModule協議

// Webview.h
#import <Foundation/Foundation.h>
#import <React/RCTBridgeModule.h>
#import <UIKit/UIKit.h>
@interface Webview : NSObject<RCTBridgeModule>
@end
3. 添加RCT_EXPORT_MODULE()宏

爲了實現RCTBridgeModule協議,Webview的類需要包含RCT_EXPORT_MODULE()宏。
並在這個宏裏面添加一個參數“WebviewPlugin”用來指定在 JavaScript 中訪問這個模塊的名字。
如果你不指定,默認就會使用這個 Objective-C 類的名字。
如果類名以 RCT 開頭,則 JavaScript 端引入的模塊名會自動移除這個前綴。

// Webview.m
#import "Webview.h"
@implementation Webview
RCT_EXPORT_MODULE(WebviewPlugin);
@end
4. 添加React Native跟控制器

如果不添加React Native跟控制器,view將不能正常顯示出來,實現方法如下:

// Webview.m
#import "Webview.h"
#import <React/RCTUtils.h>
@implementation Webview
RCT_EXPORT_MODULE(WebviewPlugin);
@end

引入<React/RCTUtils.h>之後,在視圖初始化或者顯示的時候,按照如下方法調用即可

UIViewController *vc = RCTPresentedViewController();
5. 聲明被JavaScript 調用的方法

React Native需要明確的聲明要給 JavaScript 導出的方法,否則 React Native 不會導出任何方法。聲明通過RCT_EXPORT_METHOD()宏來實現:

// Webview.m
#import "Webview.h"
#import <React/RCTUtils.h>
@implementation Webview
RCT_EXPORT_MODULE(WebviewPlugin);
RCT_EXPORT_METHOD(open:(NSDictionary *)arguments
                  withCompletionHandler:(RCTResponseSenderBlock)completion
                  failureHandler:(RCTResponseSenderBlock)failure)
{
    NSLog(@"調起打開瀏覽器方法");
}
@end
6. URL規範檢測

arguments字典是JavaScript調用方法傳參用的,arguments字典裏面的具體字段可以和JavaScript約定好,打開瀏覽器的url就是通過arguments字典傳過來的,傳過來的url字段還不能直接使用,需要檢測是否符合url規範,否則是不能正常打開網頁的。
URL規範檢測代碼如下:

- (NSString *)smartURLForString:(NSString *)str
{
    NSString *     result;
    NSString *  trimmedStr;
    NSRange     schemeMarkerRange;
    NSString *  scheme;
    assert(str != nil);
    result = nil;
    trimmedStr = [str stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceCharacterSet]];
    if ( (trimmedStr != nil) && (trimmedStr.length != 0) ) {
        schemeMarkerRange = [trimmedStr rangeOfString:@"://"];
        if (schemeMarkerRange.location == NSNotFound) {
            result = [NSString stringWithFormat:@"http://%@", trimmedStr];
        } else {
            scheme = [trimmedStr substringWithRange:NSMakeRange(0, schemeMarkerRange.location)];
            assert(scheme != nil);
            if ( ([scheme compare:@"http"  options:NSCaseInsensitiveSearch] == NSOrderedSame)
                || ([scheme compare:@"https" options:NSCaseInsensitiveSearch] == NSOrderedSame) ) {
                result = trimmedStr;
            } else {
                // It looks like this is some unsupported URL scheme.
            }
        }
    }
    return result;
}
7. 根據傳參打開瀏覽器

此瀏覽器插件支持打開自定義瀏覽器和打開默認瀏覽器,具體使用哪種方法打開瀏覽器,需要JavaScript通過arguments字典以字段的形式傳過來,這裏就使用openType字段。

// Webview.m
#import "Webview.h"
#import <React/RCTUtils.h>
@implementation Webview
RCT_EXPORT_MODULE(WebviewPlugin);
RCT_EXPORT_METHOD(open:(NSDictionary *)arguments
                  withCompletionHandler:(RCTResponseSenderBlock)completion
                  failureHandler:(RCTResponseSenderBlock)failure)
{
    if ([arguments.allKeys containsObject:@"url"]) {
        NSString *url = [NSString stringWithFormat:@"%@",arguments[@"url"]];
        NSString *openURL = [self smartURLForString:url];
        NSString *openType = arguments[@"openType"];
        if (!ValidStr(url)&&!ValidStr(openType)) {
            CIBNSLog(@"參數錯誤");
            failure(@[@{@"resultCode":@"0",@"resultMessage":@"參數錯誤"}]);
        }else{
            if ([openType isEqualToString:[NSString stringWithFormat:@"0"]]) {
                dispatch_async(dispatch_get_main_queue(), ^{
                    WebviewManager *manager = [[WebviewManager alloc]init];
                    manager.webURL = openURL;
                    UIViewController *vc = RCTPresentedViewController();
                    [vc presentViewController:manager animated:YES completion:nil];
                    completion(@[@{@"status":@"1",@"data":@"成功"}]);
                });
            }else{
                
                dispatch_async(dispatch_get_main_queue(), ^{
                    NSURL *urlStr = [NSURL URLWithString:openURL];
                    [[UIApplication sharedApplication] openURL:urlStr];
                    completion(@[@{@"status":@"1",@"data":@"成功"}]);
                });
            }
        }
    }else{
        failure(@[@{@"resultCode":@"0",@"resultMessage":@"參數錯誤"}]);
    }
}
8. Javascript調用瀏覽器方法

現在從 Javascript 裏可以這樣調用這個方法:

import { NativeModules } from "react-native";
const WebviewPlugin = NativeModules.WebviewPlugin;
WebviewPlugin.open({url:"http://www.baidu.com",openType:"1"},(msg) => {
                                         Alert.alert(JSON.stringify(msg));
                                         },(err) => {
                                         Alert.alert(JSON.stringify(err));
                                         });

希望可以幫助大家,如有問題可加QQ技術交流羣: 668562416

如果哪裏有什麼不對或者不足的地方,還望讀者多多提意見或建議

如需轉載請聯繫我,經過授權方可轉載,謝謝

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章