proteus

: Mecanismo de Layout Android

O Proteus pretende ser um substituto imediato para LayoutInflater do Android; mas, diferentemente dos layouts XML compilados incluídos no APK, o Proteus aumenta os layouts em tempo de execução. Com o Proteus, você pode controlar o layout do seu aplicativo a partir do backend (sem WebViews). Esqueça o código padrão para findViewById , converta-o em TextView e, em seguida, setText() . Proteus possui vinculações e formatadores de dados em tempo de execução. Conecte suas próprias visualizações, atributos e funções personalizados para personalizar o Proteus de acordo com suas necessidades.

• Começando
• Como funciona
• Recursos
• Contribuindo
• Licença
• Colaboradores
• StackOverflow

Começando

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

Em vez de escrever layouts em XML , no Proteus os layouts são descritos em JSON , que pode ser usado para inflar a UI nativa do Android em tempo de execução. Os layouts JSON podem ser hospedados em qualquer lugar (no dispositivo, em servidores, etc.).

O Layout define a hierarquia de visualização, assim como o XML.

Os Dados (opcional) definem vinculações de dados. Essas vinculações de dados são semelhantes à biblioteca Data Binding do Android.

Forneça o layout e data ao ProteusLayoutInflater e recupere uma hierarquia de visualização nativa.

Assista a este vídeo para vê-lo em ação.

Layout de amostra

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

Dados de amostra

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

Exemplo de código Java

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

Saída

Configurando o aplicativo de demonstração

O aplicativo de demonstração permitirá que você experimente o Proteus, além de ajudá-lo a entender melhor os detalhes internos.

• Instale o NodeJS aqui
• abrir um terminal
• cd no diretório do projeto
• execute npm start
• Inicie um emulador AVD
• Instale o aplicativo de demonstração

Pronto para mexer

• Mexa no layout e nos dados
• Clique no FAB para atualizar o aplicativo.

Recursos

• Perguntas frequentes
• Guia Detalhado
• Referências de API em construção
• Conversa DroidCon
• Vídeos de demonstração

Módulos Suportados

• Widgets Android nativos
• CartãoView v7
• Biblioteca de Design Android
• RecyclerView v7
• Suporte Android v4

Contribuindo

Como?

A maneira mais fácil de contribuir é bifurcando o repositório, fazendo suas alterações e criando uma solicitação pull.

O que?

• Adicionando novas visualizações e processadores de atributos.
• Adicionando novas funções.
• Adicionando JavaDoc e Wiki.
• Concluindo TODOs
• Escrevendo testes unitários.
• Encontrar bugs e problemas. (envie aqui)
• Correção de bugs e problemas.
• Implementar ferramentas de desempenho/benchmarking.

Licença

Apache v2.0

Se você estiver usando proteus confira a lata, não pode e deve

Colaboradores

Você pode conferir os colaboradores aqui, mas se desejar entre em contato conosco; basta enviar um e-mail.

• adityasharat
• thekirankumar
• Yasirmhd

StackOverflow

Encontre-nos no StackOverflow em proteus.

Plug-ins

Plug-in de conversão de XML para JSON com um clique

Baixe este plugin (em beta) para Android Studio. Uma vez ativado, você pode selecionar qualquer arquivo de recurso XML do Android e ir em Ferramentas > Proteus > Converter XML em JSON