Shadow是一個騰訊自主研發的Android插件框架，經過線上億級用戶量檢驗。 Shadow不僅開源分享了插件技術的關鍵代碼，還完整的分享了上線部署所需要的所有設計。

與市面上其他插件框架相比，Shadow主要具有以下特點：

• 復用獨立安裝App的源碼：插件App的源碼原本就是可以正常安裝運行的。
• 零反射無Hack實現插件技術：從理論上就已經確定無需對任何系統做兼容開發，更無任何隱藏API調用，和Google限制非公開SDK接口訪問的策略完全不沖突。
• 全動態插件框架：一次性實現完美的插件框架很難，但Shadow將這些實現全部動態化起來，使插件框架的代碼成為了插件的一部分。插件的迭代不再受宿主打包了舊版本插件框架所限制。
• 宿主增量極小：得益于全動態實現，真正合入宿主程序的代碼量極小（15KB，160方法數左右）。
• Kotlin實現：core.loader，core.transform核心代碼完全用Kotlin實現，代碼簡潔易維護。

支持特性

• 四大組件
• Fragment（代碼添加和Xml添加）
• DataBinding（無需特別支持，但已驗證可正常工作）
• 跨進程使用插件Service
• 自定義Theme
• 插件訪問宿主類
• So加載
• 分段加載插件（多Apk分別加載或多Apk以此依賴加載）
• 一個Activity中加載多個Apk中的View
• 等等……

編譯與開發環境

環境準備

第一次clone Shadow的代碼到本地后，建議先在命令行編譯一次。

• 在編譯前，必須設置ANDROID_HOME環境變量。
• 在編譯時，必須使用gradlew腳本，以保證采用了項目配置的Gradle版本。

在命令行測試編譯時可以執行這個任務：

./gradlew build

如果沒有出錯，再嘗試用Android Studio打開工程。

• 必須使用3.4或更高版本的Android Studio打開工程。(業務插件開發時沒有限制)
• 必須關閉Android Studio的Instant Run功能。

然后就可以在IDE中選擇sample-host模塊直接運行了。

?

Shadow的所有代碼都位于projects目錄下的3個目錄，分別是：

• sdk包含SDK的所有代碼
• test包含SDK的自動化測試代碼
• sample包含演示代碼

其中sample應該是大家體驗Shadow的最佳環境。 詳見sample目錄中的README介紹。

自己寫的測試代碼出錯？

以我們多年的插件環境下業務開發經驗，插件框架是不可能一步到位實現完美的。 因此，我們相信大部分業務在接入時都是需要一定的二次開發工作。 Shadow現有的代碼滿足的是我們自己的業務現在的需求。得益于全動態的設計， 插件框架和插件本身都是動態發布的，插件包里既有插件代碼也有插件框架代碼， 所以可以根據新版本插件的需要同時開發插件框架。

例如，ShadowActivity沒有實現全所有Activity方法，你寫的測試代碼可能用到了， 就會出現Method Not Found錯誤，只需要在ShadowActivity中實現對應方法就可以了。 大部分方法的實現都只是需要簡單的轉調就能工作正常。

如果遇到不會實現的功能，可以提Issue。最好附上測試代碼。

后續開發

• 原理與設計說明文檔
• 多插件支持的演示工程
• 自動化測試用例補充
• 開源包含下載能力的manager實現