从最外层源代码来看,React Native初始化过程分为两步:获取JS代码包的URL和创建RCTRootView实例,如下所示。
#import "AppDelegate.h"
#import "RCTBundleURLProvider.h"
#import "RCTRootView.h"
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
NSURL *jsCodeLocation;
jsCodeLocation = [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index.ios" fallbackResource:nil];
RCTRootView *rootView = [[RCTRootView alloc] initWithBundleURL:jsCodeLocation
moduleName:@"AwesomeProject"
initialProperties:nil
launchOptions:launchOptions];
}
@end
其中,JS代码包URL的获取是通过RCTBundleProvider这个类实现的。JS代码包的URL有两种可能结果,一种是Packager Server URL,一种是本地JS代码包的文件路径。通过jsCodeLocation = [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index.ios" fallbackResource:nil];
去获取JS代码包URL时,会首先检查是否有正在运行的Packager Server,如果有则返回相应Packager Server中JS代码包的绝对路径;如果没有正在运行的Packager Server,则会返回一个本地JS代码包的文件路径,不传递fallbackResource
参数时,默认返回 本地main.jsbundle
的文件路径。
接下来,我们具体分析一下RCTBundleProvider的工作原理。首先看看RCTBundleProvider提供的几个重要方法。
serverRootWithHost
static NSURL *serverRootWithHost(NSString *host)
{
return [NSURL URLWithString:
[NSString stringWithFormat:@"http://%@:%lu/",
host, (unsigned long)kRCTBundleURLProviderDefaultPort]];
}
该方法会根据传进去的host返回相应的Packager Server URL。例如,当传入的host为localhost时,返回的URL为http://localhost:8081/,其中8081是默认端口号,存储在常量kRCTBundleURLProviderDefaultPort
中。
isPackagerRunning
- (BOOL)isPackagerRunning:(NSString *)host
{
NSURL *url = [serverRootWithHost(host) URLByAppendingPathComponent:@"status"];
NSURLRequest *request = [NSURLRequest requestWithURL:url];
NSURLResponse *response;
NSData *data = [NSURLConnection sendSynchronousRequest:request returningResponse:&response error:NULL];
NSString *status = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
return [status isEqualToString:@"packager-status:running"];
}
该方法会判断指定host上的Packager Server是否在运行。首先,通过serverRootWithHost
方法获取该host的Packager Server URL,然后在Packager Server URL的末尾加上路径status构成新的URL,访问该URL,如果返回结果等于packager-status:running
,则证明指定host上的Packager Server正在运行。例如,当传入的host为localhost时,访问http://localhost:8081/status,如果请求返回结果为packager-status:running
,则证明localhost上的Packager Server在运行状态。
guessPackagerHost
- (NSString *)guessPackagerHost
{
static NSString *ipGuess;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
NSString *ipPath = [[NSBundle mainBundle] pathForResource:@"ip" ofType:@"txt"];
ipGuess = [[NSString stringWithContentsOfFile:ipPath encoding:NSUTF8StringEncoding error:nil]
stringByTrimmingCharactersInSet:[NSCharacterSet newlineCharacterSet]];
});
NSString *host = ipGuess ?: @"localhost";
if ([self isPackagerRunning:host]) {
return host;
}
return nil;
}
这个方法比较有意思,顾名思义,就是猜测Packager Server的host。第一次访问该方法的时候,它会首先尝试读取本地的ip.txt文件,并把文件内容存进静态变量ipGuess
中。如果最后得到的ipGuess
的值不为空,则使用ipGuess
作为host,否则默认使用localhost作为host。最后,还需要通过isPackagerRunning
方法判断得到的host上是否有Packager Server在运行,如果有才返回该host作为Packager Host,否则返回nil
。
ip.txt文件是在项目编译运行的时候通过react-native-xcode.sh
脚本生成的。在Debug模式下,react-native-xcode.sh
脚本会自动获取电脑网卡en0的ip地址并存进ip.txt,如下所示。
if [[ "$CONFIGURATION" = "Debug" && "$PLATFORM_NAME" != "iphonesimulator" ]]; then
PLISTBUDDY='/usr/libexec/PlistBuddy'
PLIST=$TARGET_BUILD_DIR/$INFOPLIST_PATH
IP=$(ipconfig getifaddr en0)
$PLISTBUDDY -c "Add NSAppTransportSecurity:NSExceptionDomains:localhost:NSTemporaryExceptionAllowsInsecureHTTPLoads bool true" "$PLIST"
$PLISTBUDDY -c "Add NSAppTransportSecurity:NSExceptionDomains:$IP.xip.io:NSTemporaryExceptionAllowsInsecureHTTPLoads bool true" "$PLIST"
echo "$IP.xip.io" > "$DEST/ip.txt"
fi
这样,在使用iphone真机调试时,只要保证iphone和电脑在同一局域网内,iphone上的React Native程序即可从电脑上运行的Packager Server加载JS代码包,无需再手动设置jsCodeLocation
。
packagerServerHost
- (NSString *)packagerServerHost
{
NSString *location = [self jsLocation];
if (location != nil) {
return location;
}
#if RCT_DEV
NSString *host = [self guessPackagerHost];
if (host) {
return host;
}
#endif
return nil;
}
该方法用于获取Packager Server Host。那既然有了guessPackagerHost
,还要这个方法干什么呢?原来,为了给使用者定制Packager Server Host的机会,RCTBundleProvider类提供了jsLocation
属性,通过设置jsLocation
属性可以直接指定Packager Server Host。因此,packagerServerHost
方法首先检查jsLocation
属性值,如果jsLocation
属性值不为空,则返回 jsLocation
值作为Packager Server Host,否则如果是Debug模式,则继续通过guessPackagerHost
方法获取Packager Server Host。以上方法都获取不到Packager Server Host时,则返回nil
。
packagerServerURL
- (NSURL *)packagerServerURL
{
NSString *const host = [self packagerServerHost];
return host ? serverRootWithHost(host) : nil;
}
该方法很简单,首先通过packagerServerHost
方法获取Packager Server Host,然后通过serverRootWithHost
方法获取Packager Server URL。
实例方法 jsBundleURLForBundleRoot
- (NSURL *)jsBundleURLForBundleRoot:(NSString *)bundleRoot fallbackResource:(NSString *)resourceName
{
resourceName = resourceName ?: @"main";
NSString *packagerServerHost = [self packagerServerHost];
if (!packagerServerHost) {
return [[NSBundle mainBundle] URLForResource:resourceName withExtension:@"jsbundle"];
} else {
return [[self class] jsBundleURLForBundleRoot:bundleRoot
packagerHost:packagerServerHost
enableDev:[self enableDev]
enableMinification:[self enableMinification]];
}
}
该方法会返回最终的JS代码包URL。它接收两个参数,一个bundleRoot,指的是Packager Server中js代码包的入口文件名。另一个是fallbackResource,指的是本地JS代码包的资源文件名,当找不到Packager Server Host时,会根据该资源文件名返回本地JS代码包的文件路径。
类方法 jsBundleURLForBundleRoot
+ (NSURL *)jsBundleURLForBundleRoot:(NSString *)bundleRoot
packagerHost:(NSString *)packagerHost
enableDev:(BOOL)enableDev
enableMinification:(BOOL)enableMinification
{
NSURLComponents *components = [NSURLComponents componentsWithURL:serverRootWithHost(packagerHost) resolvingAgainstBaseURL:NO];
components.path = [NSString stringWithFormat:@"/%@.bundle", bundleRoot];
// When we support only iOS 8 and above, use queryItems for a better API.
components.query = [NSString stringWithFormat:@"platform=ios&dev=%@&minify=%@",
enableDev ? @"true" : @"false",
enableMinification ? @"true": @"false"];
return components.URL;
}
该类方法与实例方法jsBundleURLForBundleRoot
同名,但是该方法只用于生成Packager Server的JS代码包URL。
介绍完RCTBundleProvider的重要方法,最后简单梳理一下RCTBundleProvider的调用流程。
实例方法jsBundleURLForBundleRoot
作为入口方法被调用,在该方法里面,先尝试获取Packager Server Host。如果获取到可用的Packager Server Host,则返回Packager Server中JS代码包的URL作为jsCodeLocation
。如果没有获取到可用的Packager Server Host,则返回一个本地JS代码包的文件路径作为jsCodeLocation
。