百度智能小程序 獨立分包

基礎庫 3.60.2 及以上版本開始支持。開發(fā)者工具請使用 2.2.9 及以上版本，可點此下載

• 獨立分包是小程序中一種特殊類型的分包，可以獨立于主包和其他分包運行。從獨立分包中頁面進入小程序時，不需要下載主包。當用戶進入普通分包或主包內(nèi)頁面時，主包才會被下載。
• 開發(fā)者可以按需將某些具有一定功能獨立性的頁面配置到獨立分包中。當小程序從普通的分包頁面啟動時，需要首先下載主包；而獨立分包不依賴主包即可運行，可以很大程度上提升分包頁面的啟動速度。
• 一個小程序中可以有多個獨立分包。

TIPS：
1.小游戲不支持獨立分包。
2.目前暫不支持在獨立分包中使用動態(tài)庫。

配置方法

假設小程序目錄結(jié)構(gòu)如下：

├── app.js
├── app.json
├── app.css
├── moduleA
│   └── pages
│       ├── history
│       └── search
├── moduleB
│   └── pages
│       ├── counter
│       └── goods
├── pages
│   ├── index
│   └── logs
└── utils

開發(fā)者通過在 app.json 的 subPackages 字段中對應的分包配置項中定義 independent 字段聲明對應分包為獨立分包。

{
  "pages": [
      "pages/index",
      "pages/logs"
   ],
  "subPackages": [
    {
      "root": "moduleA",
      "pages": [
          "pages/history",
          "pages/search"
       ]
    },
    {
      "root": "moduleB",
      "pages": [
          "pages/counter",
          "pages/goods"
       ],
      "independent": true
    }
  ]
}

限制

獨立分包屬于分包的一種。普通分包的所有限制都對獨立分包有效。獨立分包中自定義組件的處理方式同普通分包。

此外，使用獨立分包時要注意：

• 獨立分包中不能依賴主包和其他分包中的內(nèi)容，包括 js 文件、template、css、自定義組件等。主包中的app.css對獨立分包無效，應避免在獨立分包頁面中使用app.css中的樣式；
• App 只能在主包內(nèi)定義，獨立分包中不能定義 App，會造成無法預期的行為。

注意事項

（1）關(guān)于 getApp

與普通分包不同，獨立分包運行時，App并不一定被注冊，因此getApp也不一定可以獲得App對象：

• 當用戶從獨立分包頁面啟動小程序時，主包是不存在的，那么App也不存在，此時調(diào)用getApp獲取到的是undefined。 當用戶進入普通分包或主包內(nèi)頁面時，主包才會被下載，App才會被注冊；
• 當用戶是從普通分包或主包內(nèi)頁面跳轉(zhuǎn)到獨立分包頁面時，主包已經(jīng)存在，此時調(diào)用 getApp 可以獲取到真正的 App 實例。由于這一限制，開發(fā)者無法通過App方法實現(xiàn)獨立分包和小程序其它部分的全局變量共享。

為了在獨立分包中滿足這一需求，基礎庫3.60.2版本開始getApp支持[allowDefault]參數(shù)，在App未定義時返回一個默認實現(xiàn)。當主包加載，App被注冊時，默認實現(xiàn)中定義的屬性會被覆蓋合并到真正的App中。

代碼示例

• 獨立分包中

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

• app.js 中

App({
    data: 123,
    from: 'swan'
});

console.log(getApp()); // {global: {}, data: 456, from: 'swan'}

（2）關(guān)于 App 生命周期

當從獨立分包啟動小程序時，主包中 App 的 onLaunch 和首次 onShow 會在從獨立分包頁面首次進入主包或其他普通分包頁面時調(diào)用；由于獨立分包中無法定義 App，小程序生命周期的監(jiān)聽可以使用 swan.onAppShow， swan.onAppHide 完成。App 上的其它事件可以使用 swan.onError，swan.onPageNotFound 監(jiān)聽。

低版本兼容：

• 在低于3.60.2的基礎庫版本運行時，獨立分包視為普通分包處理，不具備獨立運行的特性；
• 在兼容模式下，主包中的 app.css 可能會對獨立分包中的頁面產(chǎn)生影響，因此應避免在獨立分包頁面中使用 app.css 中的樣式。