Beagle Defaults

Requisitos

Antes de começar a configurar o Beagle para o seu sistema Android, é importante verificar se você instalou todas as versões atuais dos seguintes programas: ‌

• JDK 11+ language
• Android API level: at least 19 or higher
• Kotlin 1.5+

Primeiros Passos

Este tutorial irá configurar o Beagle desde o início.

Passo 1: Adicione uma configuração ao arquivo Gradle em seu projeto:

• Adicione mavenCentral () no bloco All projects em seu arquivo do Projeto Gradle (build.gradle)
  

allprojects {
    repositories {
        google()
        jcenter()
        mavenCentral()
    }
}

Passo 2: Adicione o plugin kotlin kapt e 3 dependências no gerenciador de dependências do seu aplicativo (gradle.gradle)

• Os números de versão listados abaixo podem ter sido atualizados. Verifique as versões reais nas tags acima:

apply plugin: 'kotlin-kapt'
android {
    kotlinOptions {
        jvmTarget = JavaVersion.VERSION_11
    }
}
dependencies {
    implementation "br.com.zup.beagle:android:1.10.0"
    kapt "br.com.zup.beagle:android-processor:1.10.0"
    implementation "br.com.zup.beagle:beagle-defaults:1.7.1"
}

Passo 3: Crie 4 arquivos de configuração para o Beagle.

• Esses arquivos definirão algumas configurações e classes usadas pelo Beagle.
  
  • se precisar de informações mais detalhadas, verifique a documentação.

1. Crie um arquivo AppBeagleConfig que herde da classe BeagleConfig:

@BeagleComponent
class AppBeagleConfig: BeagleConfig {
    override val environment: Environment = Environment.DEBUG
    override val baseUrl: String = "https://adopt-beagle.continuousplatform.com/scaffold"
}

2. Crie um arquivo HttpApp conforme listado abaixo. Esta classe herda de uma classe ´HttpClientDefault()´ na biblioteca Beagle-Default:

@BeagleComponent
class HttpApp: HttpClientDefault()

3. Crie um arquivo LoggerApp conforme listado abaixo. Esta classe herda de uma classe ´BeagleLoggerDefault()´ na biblioteca Beagle-Default:

@BeagleComponent
class LoggerApp: BeagleLoggerDefault()

Passo 4: Construa seu projeto: Ao construir este aplicativo, a configuração acima irá configurar o Beagle em seu projeto.

Passo 5: Crie um arquivo AppAplication, veja o exemplo abaixo:

class AppApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        APPLICATION = this
        BeagleSetup().init(this)
    }
    companion object {
        var APPLICATION: Application? = null
    }
}

Passo 6: Teste seu aplicativo

Para testá-lo, basta chamar uma tela de nosso exemplo do BFF.
Para fazer isso, você precisa iniciar uma activity usando a configuração abaixo:

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
       
        val intent = this.newServerDrivenIntent<ServerDrivenActivity>(RequestData("/components"))
        startActivity(intent)
    }
}

Uma tela de amostra com todos os componentes do Beagle será exibida na tela do emulador

Para saber mais sobre o Beagle: Acesse o repositório.

Para saber mais sobre o Beagle-Scaffold, veja a seção Beagle-Scaffold.

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.