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”