试读angular源码第一章：开场与platformBrowserDynamic

createPlatformFactory 返回的方法

获取当前平台实例

如果当前平台实例不存在并且不存在 AllowMultipleToken 这个允许多个令牌的服务提供者

父级平台工厂方法 parentPlatformFactory 存在，则合并服务提供商并递归调用 parentPlatformFactory

父级平台工厂方法 parentPlatformFactory 不存在，则使用注入器创建实例方法 Injector.create 创建实例平台实例并用 createPlatform 设置为全局的平台实例

调用 assertPlatform 确认 IOC 容器中存在 该 marker 的平台实例并返回

所以创建平台实例的顺序上，应该是 合并 browserDynamic 的 provider => 合并 coreDynamic 的 provider => 合并 provider 并创建 core

大概用人话描述就是：

判断是否已经创建过了

判断是否有父 Factory

如果有父 Factory 就把调用 Factory 时传入的 Provider 和调用 createPlatformFactory 传入的 Provider 合并，然后调用父 Factory

如果没有父 Factory ，先创建一个 Injector ，然后去创建 PlatformRef 实例

angular/packages/core/src/application_ref.ts

let _platform: PlatformRef;

/**
 * Creates a platform.
 * Platforms have to be eagerly created via this function.
 *
 * @publicApi
 */
export function createPlatform(injector: Injector): PlatformRef {
  if (_platform && !_platform.destroyed &&
      !_platform.injector.get(ALLOW_MULTIPLE_PLATFORMS, false)) {
    throw new Error(
        "There can be only one platform. Destroy the previous one to create a new one.");
  }
  _platform = injector.get(PlatformRef);
  const inits = injector.get(PLATFORM_INITIALIZER, null);
  if (inits) inits.forEach((init: any) => init());
  return _platform;
}

_platform 是全局的唯一平台实例。

创建平台实例关键方法，传入服务注入器实例 injector 返回平台实例：

确认全局的平台实例存在，状态不是被销毁，并且不存在多个平台实例

从注入器中获取平台实例

injector.get(PLATFORM_INITIALIZER, null) 获取初始化平台时需要执行的函数并执行

回过头看 platformBrowserDynamic：

angular/packages/platform-browser-dynamic/src/platform-browser-dynamic.ts

/**
 * @publicApi
 */
export const platformBrowserDynamic = createPlatformFactory(
    platformCoreDynamic, "browserDynamic", INTERNAL_BROWSER_DYNAMIC_PLATFORM_PROVIDERS);

重点来了：INTERNAL_BROWSER_DYNAMIC_PLATFORM_PROVIDERS

这个 providers 究竟提供了什么服务？

angular/packages/platform-browser-dynamic/src/platform_providers.ts

/**
 * @publicApi
 */
export const INTERNAL_BROWSER_DYNAMIC_PLATFORM_PROVIDERS: StaticProvider[] = [
  INTERNAL_BROWSER_PLATFORM_PROVIDERS,
  {
    provide: COMPILER_OPTIONS,
    useValue: {providers: [{provide: ResourceLoader, useClass: ResourceLoaderImpl, deps: []}]},
    multi: true
  },
  {provide: PLATFORM_ID, useValue: PLATFORM_BROWSER_ID},
];

除了 COMPILER_OPTIONS 和 PLATFORM_ID，大概重点就是 INTERNAL_BROWSER_PLATFORM_PROVIDERS 了吧。

INTERNAL_BROWSER_PLATFORM_PROVIDERS 来自 @angular/platform-browser：

angular/packages/platform-browser/src/browser.ts

export const INTERNAL_BROWSER_PLATFORM_PROVIDERS: StaticProvider[] = [
  {provide: PLATFORM_ID, useValue: PLATFORM_BROWSER_ID},
  {provide: PLATFORM_INITIALIZER, useValue: initDomAdapter, multi: true},
  {provide: PlatformLocation, useClass: BrowserPlatformLocation, deps: [DOCUMENT]},
  {provide: DOCUMENT, useFactory: _document, deps: []},
];

@angular/platform-browser 提供了一些浏览器端的ng实现：

PLATFORM_INITIALIZER 是初始化需要执行的方法集合 这个很重要

DOCUMENT 浏览器端的 document ，_document 工厂方法返回 document

在上面，createPlatform 的时候，会 const inits = injector.get(PLATFORM_INITIALIZER, null); if (inits) inits.forEach((init: any) => init()); 依次执行 PLATFORM_INITIALIZER 注入的工厂方法。

那么来看看 initDomAdapter 吧：

angular/packages/platform-browser/src/browser.ts

export function initDomAdapter() {
  BrowserDomAdapter.makeCurrent();
  BrowserGetTestability.init();
}

BrowserDomAdapter.makeCurrent(); 通过 BrowserDomAdapter 的静态方法实例化一个 BrowserDomAdapter 全局DOM适配器 ，具体就是实现并封装了一些在浏览器端的方法，具体的可以看 angular/packages/platform-browser/src/browser/browser_adapter.ts 中的 class BrowserDomAdapter extends GenericBrowserDomAdapter

BrowserGetTestability.init(); 则是初始化 angular 的测试，这个就没看了

回过头看下，在创建 platformBrowserDynamic 时候，传入了返回父平台实例的方法 platformCoreDynamic

angular/packages/platform-browser-dynamic/src/platform_core_dynamic.ts

import {COMPILER_OPTIONS, CompilerFactory, PlatformRef, StaticProvider, createPlatformFactory, platformCore} from "@angular/core";
import {JitCompilerFactory} from "./compiler_factory";

/**
 * A platform that included corePlatform and the compiler.
 *
 * @publicApi
 */
export const platformCoreDynamic = createPlatformFactory(platformCore, "coreDynamic", [
  {provide: COMPILER_OPTIONS, useValue: {}, multi: true},
  {provide: CompilerFactory, useClass: JitCompilerFactory, deps: [COMPILER_OPTIONS]},
]);

platformCoreDynamic 又传入了

来自 @angular/core 的 平台核心 platformCore

平台名 coreDynamic

2个静态服务提供者：编译选项 COMPILER_OPTIONS 和 platformDynamic 的JIT编译器工厂 JitCompilerFactory

angular/packages/core/src/platform_core_providers.ts

import {PlatformRef, createPlatformFactory} from "./application_ref";
import {PLATFORM_ID} from "./application_tokens";
import {Console} from "./console";
import {Injector, StaticProvider} from "./di";
import {TestabilityRegistry} from "./testability/testability";

const _CORE_PLATFORM_PROVIDERS: StaticProvider[] = [
  // Set a default platform name for platforms that don"t set it explicitly.
  {provide: PLATFORM_ID, useValue: "unknown"},
  // 在这里 PlatformRef 被加入了 injector 并在 createPlatformFactory 中实例化
  {provide: PlatformRef, deps: [Injector]},
  {provide: TestabilityRegistry, deps: []},
  {provide: Console, deps: []},
];

/**
 * This platform has to be included in any other platform
 *
 * @publicApi
 */
export const platformCore = createPlatformFactory(null, "core", _CORE_PLATFORM_PROVIDERS);

platformCore 则是创建了一个返回根平台工厂实例的方法，并设置了4个基础的DI的服务提供者

PLATFORM_ID 平台id

PlatformRef 在这里 PlatformRef 被加入了 injector 并在后续的 createPlatformFactory 中通过 createPlatform(Injector.create({providers: injectedProviders, name: desc})); 平台实例会被实例化

TestabilityRegistry 可测试性注册表 测试相关

Console 很有意思 angular 把 Console 作为服务注入了DI，但是 Console 只实现了 log和warn两个方法

angular/packages/core/src/application_ref.ts

@Injectable()
export class PlatformRef {
  private _modules: NgModuleRef<any>[] = [];
  private _destroyListeners: Function[] = [];
  private _destroyed: boolean = false;

  /** @internal */
  constructor(private _injector: Injector) {}

  bootstrapModuleFactory(moduleFactory: NgModuleFactory, options");Promise> {
        ...
  }

  bootstrapModule(
      moduleType: Type, compilerOptions: (CompilerOptions&BootstrapOptions)|
      Array = []): Promise> {
    const options = optionsReducer({}, compilerOptions);
    return compileNgModuleFactory(this.injector, options, moduleType)
        .then(moduleFactory => this.bootstrapModuleFactory(moduleFactory, options));
  }

  private _moduleDoBootstrap(moduleRef: InternalNgModuleRef<any>): void {
    ...
  }

  onDestroy(callback: () => void): void { this._destroyListeners.push(callback); }

  get injector(): Injector { return this._injector; }

  destroy() {
    if (this._destroyed) {
      throw new Error("The platform has already been destroyed!");
    }
    this._modules.slice().forEach(module => module.destroy());
    this._destroyListeners.forEach(listener => listener());
    this._destroyed = true;
  }

  get destroyed() { return this._destroyed; }
}

PlatformRef 就是平台实例的类，有一些方法和属性等，例如几个关键的方法

bootstrapModule 引导根模块的方法

bootstrapModuleFactory 实例模块的工厂方法，会运行 zone.js 并监听事件

destroy 销毁平台实例的方法

这个我们放到后文去说吧

调用 platformBrowserDynamic() 并生成平台实例 PlatformRef 时大概经历了这些：

调用 createPlatformFactory 合并平台 browserDynamic 的 providers 并触发父级平台 coreDynamic 的平台工厂函数

调用 createPlatformFactory 合并平台 coreDynamic 的 providers 并触发父级平台 core 的平台工厂函数

由于平台 core 无父级平台，调用 Injector.create 创建 PlatformRef 实例，并赋值给全局唯一的平台实例 _platform

在 createPlatform 创建 PlatformRef 的时候，实例化一个 BrowserDomAdapter 全局DOM适配器 ，具体就是实现并封装了一些在浏览器端的方法

最后断言，确认存在 PlatformRef 实例，并返回 PlatformRef 实例