├── app.js
├── app.json
├── app.ttss
├── packageA
│   └── pages
│       ├── pageOne
│       └── pageTwo
├── packageB
│   └── pages
│       ├── pageThree
│       └── pageFour
├── pages
│   ├── index
│   └── logs
└── utils

开发者通过在 app.json 的 subpackages 字段中对应的分包配置项中定义 independent 字段声明对应分包为独立分包。

{ 
  "pages": ["pages/index", "pages/logs"],
  "subpackages": [
    {
      "root": "packageA",
      "pages": ["pages/pageOne", "pages/pageTwo"]
    },
    {
      "root": "packageB",
      "name": "pack2",
      "pages": ["pages/pageThree", "pages/pageFour"],
      "independent": true
    }
  ]
}

限制

独立分包属于分包的一种。普通分包的所有限制都对独立分包有效。独立分包中自定义组件的处理方式同普通分包。此外，使用独立分包时要注意：

•

独立分包中不能依赖主包和其他分包中的内容，包括 js 文件、template、ttss、sjs、图片、自定义组件等。主包中的 app.ttss 对独立分包无效，应避免在独立分包页面中使用 app.ttss 中的样式。

•

App 只能在主包内定义，独立分包中不能定义 App，会造成无法预期的行为。

注意事项

`getApp()`

与普通分包不同，独立分包运行时，App 并不一定被注册，因此 getApp() 也不一定可以获得 App 对象：

•

当用户从独立分包页面启动小程序时，主包不存在，App 也不存在。此时调用 getApp() 获取到的是 undefined。当用户进入普通分包或主包内页面时，主包才会被下载，App 才会被注册。

•

当用户是从普通分包或主包内页面跳转到独立分包页面时，主包已经存在，此时调用 getApp() 可以获取 App。由于这一限制，开发者无法通过 App 对象实现独立分包和小程序其他部分的全局变量共享。

•

在独立分包中 getApp 支持 [allowDefault] 参数，在 App 未定义时返回一个默认实现。当主包加载，App 被注册时，默认实现中定义的属性会被覆盖合并到 App 中。

示例代码：

•

独立分包中：

const app = getApp({allowDefault: true}); // {}
app.data = 456;
app.global = {};

•

app.js 中：

App({
  data: 123,
  other: 'hello'
});
 
console.log(getApp()); // {global: {}, data: 456, other: 'hello'}

`App` 生命周期

当从独立分包启动小程序时，主包中 App 的 onLaunch 和首次 onShow 会在从独立分包页面首次进入主包或其他普通分包页面时调用。

由于独立分包中无法定义 App，小程序生命周期的监听可以使用 tt.onAppShow，tt.onAppHide 完成。App 上的其他事件可以使用 tt.onError 监听。

低版本兼容

在低于 1.88.0 版本的宿主中运行时，独立分包视为普通分包处理，不具备独立运行的特性。

注意
在兼容模式下，主包中的 app.ttss 可能会对独立分包中的页面产生影响，因此应避免在独立分包页面中使用 app.ttss 中的样式。

独立分包收藏我的收藏

使用方法

限制

注意事项

getApp()

App 生命周期

低版本兼容

独立分包
收藏
我的收藏

`getApp()`

`App` 生命周期