proteus

：Android佈局引擎

Proteus旨在成為 Android LayoutInflater的直接替代品；但與 APK 中捆綁的已編譯 XML 佈局不同，Proteus 在運行時會擴展佈局。使用Proteus，您可以從後端控制您的應用程式佈局（無WebViews）。忘記findViewById的樣板程式碼，將其轉換為TextView ，然後setText() 。 Proteus 具有運行時資料綁定和格式化程式。插入您自己的自訂視圖、屬性和函數，以根據您的要求調整 proteus。

• 入門
• 它是如何運作的
• 資源
• 貢獻
• 執照
• 貢獻者
• 堆疊溢位

入門

漸變（漸層 4.10.*）

 // Add it in your root build.gradle at the end of repositories:
allprojects {
    repositories {
        google ( )
        jcenter ( )
        maven { url 'https://jitpack.io' }
    }
} 

 // Add in your app level dependency
dependencies {
    implementation 'com.github.flipkart-incubator.proteus:proteus-core:5.0.1'
    implementation 'com.github.flipkart-incubator.proteus:gson-adapter:5.0.1'
    implementation 'com.github.flipkart-incubator.proteus:cardview-v7:5.0.1'
    implementation 'com.github.flipkart-incubator.proteus:design:5.0.1'
    implementation 'com.github.flipkart-incubator.proteus:recyclerview-v7:5.0.1'
    implementation 'com.github.flipkart-incubator.proteus:support-v4:5.0.1'
}

它是如何運作的

proteus中的佈局不是用XML編寫，而是用JSON描述，可用於在運行時擴充原生 Android UI。 JSON佈局可以託管在任何地方（在裝置上、伺服器上等）。

佈局定義了視圖層次結構，就像 XML 一樣。

資料（可選）定義資料綁定。這些資料綁定類似於 Android 的資料綁定庫。

將layout和data提供給ProteusLayoutInflater並傳回本機視圖層次結構。

觀看此影片以了解其實際效果。

佈局範例

 {
  "type" : "LinearLayout" ,
  "orientation" : "vertical" ,
  "padding" : "16dp" ,
  "children" : [ {
    "layout_width" : "200dp" ,
    "gravity" : "center" ,
    "type" : "TextView" ,
    "text" : "@{user.profile.name}"
  } , {
    "type" : "HorizontalProgressBar" ,
    "layout_width" : "200dp" ,
    "layout_marginTop" : "8dp" ,
    "max" : 6000 ,
    "progress" : "@{user.profile.experience}"
  } ]
} 

樣本數據

 {
  "user" : {
    "profile" : {
      "name" : "John Doe" ,
      "experience" : 4192
    }
  }
}

Java 程式碼範例

 ProteusView view = proteusLayoutInflater . inflate (< layout >, < data >);
container . addView ( view . getAsView ());

輸出

設定演示應用程式

演示應用程式將讓您體驗 proteus 並幫助您更好地了解內部結構。

• 在這裡安裝 NodeJS
• 打開終端
• cd 進入專案目錄
• 運行npm start
• 啟動 AVD 模擬器
• 安裝演示應用程式

準備修補

• 修改佈局和數據
• 點擊 FAB 刷新應用程式。

資源

• 常問問題
• 詳細指南
• API 參考資料正在建置中
• DroidCon 演講
• 示範影片

支援的模組

• 原生 Android 小工具
• 卡片視圖 v7
• Android設計庫
• 回收視圖 v7
• 安卓支援 v4

貢獻

如何？

最簡單的貢獻方法是分叉儲存庫、進行更改並建立拉取請求。

什麼？

• 新增新的視圖和屬性處理器。
• 新增功能。
• 新增 JavaDoc 和 Wiki。
• 完成待辦事項
• 編寫單元測試。
• 尋找錯誤和問題。 （在此提交）
• 修復錯誤和問題。
• 實施性能/基準測試工具。

執照

阿帕契v2.0

如果您使用的是proteus，請檢查can、cannot 和must

貢獻者

您可以在此處查看貢獻者，但如果您想聯繫我們；只需發送郵件即可。

• 阿迪亞沙拉特
• 泰基蘭庫馬爾
• 亞西姆赫德

堆疊溢位

在 StackOverflow 上找到我們的 proteus。

外掛

一鍵式 XML 到 JSON 轉換插件

下載適用於 Android Studio 的此外掛程式（測試版）。啟用後，您可以選擇任何 Android XML 資源文件，然後轉到“工具”>“Proteus”>“將 XML 轉換為 JSON”