proteus

: Android-Layout-Engine

Proteus soll ein direkter Ersatz für Androids LayoutInflater sein; aber im Gegensatz zu den kompilierten XML-Layouts, die im APK gebündelt sind, bläht Proteus Layouts zur Laufzeit auf. Mit Proteus können Sie Ihr Apps-Layout vom Backend aus steuern (keine WebViews). Vergessen Sie den Boilerplate-Code für findViewById , wandeln Sie ihn in eine TextView um und setzen Sie dann setText() . Proteus verfügt über Laufzeitdatenbindungen und Formatierer. Fügen Sie Ihre eigenen benutzerdefinierten Ansichten sowie Attribute und Funktionen hinzu, um Proteus an Ihre Anforderungen anzupassen.

• Erste Schritte
• Wie es funktioniert
• Ressourcen
• Mitwirken
• Lizenz
• Mitwirkende
• StackOverflow

Erste Schritte

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

Wie es funktioniert

Anstatt Layouts in XML zu schreiben, werden in Proteus Layouts in JSON beschrieben, die zur Erweiterung der nativen Android-Benutzeroberfläche zur Laufzeit verwendet werden können. Die JSON Layouts können überall gehostet werden (auf dem Gerät, auf Servern usw.).

Das Layout definiert die Ansichtshierarchie, genau wie XML.

Die Daten (optional) definieren Datenbindungen. Diese Datenbindungen ähneln der Datenbindungsbibliothek von Android.

Übergeben Sie das layout und data an ProteusLayoutInflater und erhalten Sie eine native Ansichtshierarchie zurück.

Sehen Sie sich dieses Video an, um es in Aktion zu sehen.

Beispiellayout

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

Beispieldaten

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

Beispiel-Java-Code

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

Ausgabe

Einrichten der Demo-App

Mit der Demo-App können Sie mit Proteus herumspielen und die Funktionsweise besser verstehen.

• Installieren Sie NodeJS hier
• ein Terminal öffnen
• cd in das Projektverzeichnis
• Führen Sie npm start
• Starten Sie einen AVD-Emulator
• Installieren Sie die Demo-App

Bereit zum Basteln

• Basteln Sie am Layout und an den Daten herum
• Klicken Sie auf FAB, um die App zu aktualisieren.

Ressourcen

• FAQ
• Detaillierte Anleitung
• API-Referenzen im Aufbau
• DroidCon-Talk
• Demovideos

Unterstützte Module

• Native Android-Widgets
• CardView v7
• Android-Designbibliothek
• RecyclerView v7
• Android-Unterstützung v4

Mitwirken

Wie?

Der einfachste Weg, einen Beitrag zu leisten, besteht darin, das Repo zu forken, Ihre Änderungen vorzunehmen und eine Pull-Anfrage zu erstellen.

Was?

• Hinzufügen neuer Ansichten und Attributprozessoren.
• Neue Funktionen hinzufügen.
• JavaDoc und Wiki hinzufügen.
• TODOs abschließen
• Unit-Tests schreiben.
• Finden von Fehlern und Problemen. (hier einreichen)
• Behebung von Fehlern und Problemen.
• Implementieren Sie Leistungs-/Benchmarking-Tools.

Lizenz

Apache v2.0

Wenn Sie Proteus verwenden, schauen Sie sich die Dose, Dose und Notwendigkeit an

Mitwirkende

Sie können sich die Mitwirkenden hier ansehen, aber wenn Sie uns kontaktieren möchten; schreib einfach eine Mail.

• adityasharat
• thekirankumar
• yasirmhd

StackOverflow

Finden Sie uns auf StackOverflow unter proteus.

Plugins

XML-zu-JSON-Konvertierungs-Plugin mit einem Klick

Laden Sie dieses Plugin (in der Betaversion) für Android Studio herunter. Nach der Aktivierung können Sie eine beliebige Android-XML-Ressourcendatei auswählen und zu Extras > Proteus > XML in JSON konvertieren gehen