Configuração do projeto

Configuração Inicial

O download de dependências é realizado via Maven, conforme exemplo abaixo:

// No arquivo build.gradle(.kts) do projeto, apontar:

allprojects {
    repositories {
        google()
        mavenCentral()
        mavenLocal()
        maven {
            url = uri("https://maven.pkg.github.com/getzoop/zoop-package-public")

            credentials {
                username = "MyCompanyGH"    // Seu usuário do GitHub.
                password = "github_pat_..." // Sua PAT do GitHub.
            }
        }
    }
}

Adicione a dependência do plugin de acordo com a(s) plataforma(s) do seu projeto.

Kotlin Multiplatform (KMP)

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                // Sendo X.Y.Z a versão desejada.
                implementation("br.zoop.pos.plugin:zoop-pos-plugin-desktop:X.Y.Z")
            }
        }
    }
}

Android

dependencies {
    // Sendo X.Y.Z a versão desejada.
    implementation("br.zoop.pos.plugin:zoop-pos-plugin-desktop-android:X.Y.Z")
}

JVM

dependencies {
    // Sendo X.Y.Z a versão desejada.
    implementation("br.zoop.pos.plugin:zoop-pos-plugin-desktop-jvm:X.Y.Z")
}

A GitHub personal access token (PAT) usada deve possuir no mínimo permissão para ler e obter pacotes/artefatos de repositórios públicos.

Caso você tenha dúvidas a respeito da GitHub PAT, acesse a página de nosso repositório público. Já no README, apresentamos um guia para orientá-lo sobre como gerar uma GitHub PAT e quais permissões conceder a ela.

Dependências

Adicionar ao build.gradle(.kts) a nível de módulo:

android {
    packagingOptions {
        jniLibs {
            useLegacyPackaging = true
        }
    }
}

dependencies {
    implementation("org.jetbrains.kotlin:kotlin-reflect:1.9.0")
    implementation("org.jetbrains.kotlinx:kotlinx-datetime:0.3.0")
    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.5.1")
}

Após esse passo, você estará pronto para consumir os serviços do plugin, seguindo para a inicialização.

Permissões

Para aplicações Android, é necessário permitir acesso à Internet.

<uses-permission android:name="android.permission.INTERNET" />