Como gerar uma versão do Beagle local ou remota

Nesta seção, você encontra como gerar versões locais do Beagle ou versões remotas para o seu repositório quando necessário.

Siga as orientações de acordo com o sistema operacional que estiver usando:

Configurando o Gradle

Se você trabalha com aplicações Android ou via Backend, deve começar configurando o arquivo**gradle.properties**, que se encontra na **pasta root**. Essa configuração vale tanto para versões remotas como locais.

Assim que abrir o arquivo, o primeiro passo é mudar o nome da versão que será gerada. Para isso, você pode alterar o valor da variável **VERSION_NAME**para o valor desejado.

Além disso, é preciso acrescentar uma variável chamada RELEASE_SIGNING_ENABLED e atribui-lá ao valor false. Isso significa que você não precisa assinar a versão, já que essa configuração permite gerar uma versão do Beagle de forma local ou para um repositório próprio.

Depois que terminar essas configurações, você terá de ter no seu gradel as seguintes variáveis de acordo com o nome que escolher para sua versão (neste exemplo, usamos**beagle-test**):

VERSION_NAME=beagle-test 
RELEASE_SIGNING_ENABLED=false

Publicando em um repositório remoto

Ao final da configuração do gradle.properties, você precisa configurar um arquivo que está na pasta root do Beagle, no caso, o maven-publish.gradle. Nesse arquivo, adicione um target, que definirá:

  • Em qual repositório será gerado a versão
  • As credenciais necessárias para acessar esse repositório.
ChavesDefinição
releaseRepositoryUrlURL do repositório onde a versão será gerada.
repositoryUsernameNome de usuário.
repositoryPasswordSenha do nome de usuário declarado.

Segue abaixo um exemplo de publicação:

apply plugin: "com.vanniktech.maven.publish"

def versionName = System.env.VERSION_DEPLOY != null ? System.env.VERSION_DEPLOY : VERSION_NAME ?: ""

version = versionName

mavenPublish {
nexus {
    		stagingProfile = "br.com.zup"
	}
	targets {
    		uploadArchives {    
        	releaseRepositoryUrl = "https://meu-repo.com.br"
        	repositoryUsername = "username"
        	repositoryPassword = "password"
    		}
	}
}

Publicando em um repositório local

Ao final da configuração do gradle.properties , você deve rodar alguns comandos do gradle.

Para isso, vá até a pasta root da plataforma em que você deseja gerar versão (Android ou Backend) e no terminal de sua preferência execute o seguinte comando:

Se estiver em um terminal do Windows:

gradlew clean build publishToMavenLocal

Caso esteja nos demais terminais:

./gradlew clean build publishToMavenLocal

Depois de rodar o comando, a versão será gerada automaticamente.

Diferente da configuração para Android e Backend, em aplicações iOS você não precisa configurar o arquivo gradle.properties. Nesse caso, basta seguir direto para as configurações de acordo com a versão que deseja gerar.

Publicando em um repositório remoto

Usando o CocoaPods

No arquivo podfile , assim como qualquer outra dependência, coloque o Beagle e aponte o endereço do seu repositório , como no exemplo a baixo:

pod 'Beagle', :git => 'https://github.com/profile/myrepo'

Depois de configurado o podfile execute o seguinte comando para baixar do seu repositório:

pod install

Usando o Carthage

No arquivo Cartfile, adicione o repositório da sua versão do Beagle:

github “YourUser/YourRepository”

Publicando em um repositório local

Usando o CocoaPods

Abra o terminal e vá para a pasta raiz do Beagle e digite o seguinte comando:

pod spec create MyBeagle

E MyBeagle.podspec será criado. Agora abra esse arquivo com um editor de texto e siga como o exemplo abaixo:

Pod::Spec.new do |spec|

spec.name = "MyBeagle"
spec.version = "1.0.0"
spec.summary = "A short description"
spec.description = "Complete description"

spec.platform = :ios, "12.2"

spec.source = { :path => '.' }

Em seguida execute o seguinte comando no terminal com a pasta raiz do projeto:

pod install

Usando o Carthage

No arquivo Cartfile, adicione o diretório da sua versão do Beagle da seguinte forma:

git "file:////Users/beagle" "master"

Última modificação 11/02/2021: create content (#298) (43225e15)