proteus

: Механизм компоновки Android

Proteus задуман как замена Android LayoutInflater ; но в отличие от скомпилированных макетов XML, включенных в APK, Proteus раздувает макеты во время выполнения. С помощью Proteus вы можете управлять макетом своих приложений из серверной части (без WebViews). Забудьте шаблонный код findViewById , приведите его к TextView , а затем setText() . Proteus имеет привязки данных и средства форматирования во время выполнения. Подключайте свои собственные представления, атрибуты и функции, чтобы адаптировать Proteus под свои требования.

• Начиная
• Как это работает
• Ресурсы
• Содействие
• Лицензия
• Авторы
• StackOverflow

Начиная

градиент (градус 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'
}

Как это работает

Вместо написания макетов в XML , в Proteus макеты описываются в JSON , который можно использовать для раздувания собственного пользовательского интерфейса Android во время выполнения. Макеты 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 здесь
• открыть терминал
• перейдите в каталог проекта
• запустить npm start
• Запустите эмулятор AVD
• Установите демо-приложение

Готов повозиться

• Повозитесь с макетом и данными
• Нажмите FAB, чтобы обновить приложение.

Ресурсы

• Часто задаваемые вопросы
• Подробное руководство
• Ссылки на API в разработке
• Обсуждение на ДроидКоне
• Демо-видео

Поддерживаемые модули

• Родные виджеты Android
• КардВью v7
• Библиотека дизайна Android
• РесайлерВью v7
• Поддержка Android v4

Содействие

Как?

Самый простой способ внести свой вклад — создать форк репо, внести изменения и создать запрос на включение.

Что?

• Добавление новых представлений и обработчиков атрибутов.
• Добавление новых функций.
• Добавление JavaDoc и Wiki.
• Выполнение TODO
• Написание модульных тестов.
• Поиск ошибок и проблем. (отправьте сюда)
• Исправление ошибок и проблем.
• Внедрить инструменты производительности/бенчмаркинга.

Лицензия

Апач v2.0

Если вы используете Proteus, проверьте, можно, нельзя и нужно.

Авторы

Вы можете проверить авторов здесь, но если вы хотите связаться с нами; просто напишите письмо.

• Адитьяшарат
• Текиранкумар
• Ясирмхд

StackOverflow

Найдите нас на StackOverflow в Proteus.

Плагины

Плагин преобразования XML в JSON в один клик

Загрузите этот плагин (в бета-версии) для Android Studio. После включения вы можете выбрать любой XML-файл ресурсов Android и перейти в «Инструменты» > «Proteus» > «Преобразовать XML в JSON».