React Native OC源码阅读—RCTBundlePro
从最外层源代码来看，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。
