proteus

: Motor de diseño de Android

Proteus está destinado a ser un reemplazo directo para LayoutInflater de Android; pero a diferencia de los diseños XML compilados incluidos en el APK, Proteus infla los diseños en tiempo de ejecución. Con Proteus, puedes controlar el diseño de tus aplicaciones desde el backend (sin WebViews). Olvídese del código repetitivo para findViewById , transmítalo a TextView y luego setText() . Proteus tiene formateadores y enlaces de datos en tiempo de ejecución. Conecte sus propias vistas, atributos y funciones personalizados para adaptar Proteus a sus necesidades.

• Empezando
• Cómo funciona
• Recursos
• Contribuyendo
• Licencia
• Colaboradores
• Desbordamiento de pila

Empezando

gradle (gradle 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'
}

como funciona

En lugar de escribir diseños en XML , en proteus los diseños se describen en JSON , que se puede utilizar para inflar la interfaz de usuario nativa de Android en tiempo de ejecución. Los diseños JSON se pueden alojar en cualquier lugar (en el dispositivo, en servidores, etc.).

El diseño define la jerarquía de vistas, al igual que XML.

Los datos (opcional) definen enlaces de datos. Estos enlaces de datos son similares a la biblioteca de enlace de datos de Android.

Proporcione el layout y data a ProteusLayoutInflater y recupere una jerarquía de vistas nativa.

Mire este vídeo para verlo en acción.

Diseño de muestra

 {
  "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}"
  } ]
} 

Datos de muestra

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

Código Java de muestra

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

Producción

Configurar la aplicación de demostración

La aplicación de demostración te permitirá jugar con proteus y también te ayudará a comprender mejor los aspectos internos.

• Instale NodeJS aquí
• abrir una terminal
• cd en el directorio del proyecto
• ejecutar npm start
• Iniciar un emulador AVD
• Instale la aplicación de demostración

Listo para jugar

• Juega con el diseño y los datos
• Presione FAB para actualizar la aplicación.

Recursos

• Preguntas frecuentes
• Guía detallada
• Referencias API en construcción
• Charla de DroidCon
• Vídeos de demostración

Módulos compatibles

• Widgets nativos de Android
• CardView v7
• Biblioteca de diseño de Android
• RecicladorView v7
• Soporte Android v4

Contribuyendo

¿Cómo?

La forma más sencilla de contribuir es bifurcando el repositorio, realizando cambios y creando una solicitud de extracción.

¿Qué?

• Agregar nuevas vistas y procesadores de atributos.
• Añadiendo nuevas funciones.
• Agregando JavaDoc y Wiki.
• Completar tareas pendientes
• Redacción de pruebas unitarias.
• Encontrar errores y problemas. (enviar aquí)
• Corrección de errores y problemas.
• Implementar herramientas de desempeño/evaluación comparativa.

Licencia

apache v2.0

Si está usando proteus, consulte la lata, no puede y debe

Colaboradores

Puede consultar los colaboradores aquí, pero si desea contactarnos; simplemente envíe un correo.

• adityasharat
• thekirankumar
• yasirmhd

Desbordamiento de pila

Encuéntrenos en StackOverflow en proteus.

Complementos

Complemento de conversión de XML a JSON con un clic

Descargue este complemento (en versión beta) para Android Studio. Una vez habilitado, puede seleccionar cualquier archivo de recursos XML de Android e ir a Herramientas > Proteus > Convertir XML a JSON.