Nexte
O Nexte tem como objetivo promover a integração entre tenistas a partir da realização de desafios entre os membros desta comunidade. Não obstante, Nexte é desenvolvido com tecnologias modernas como: Docker, Kotlin, Node, e muitas outras.
For english support, read out README provided in english.
Primeiros Passos
É nessário realizar alguns passos antes de começar.
Prerequisitos e Instalação
Neste momento, é necessário instalar o Android Studio com a SDK 22. Se ainda não fez isso, por favor siga os passos disponibilizados na Documentação Oficial do Android.
CI e Docker
O processo de integração continua utilizada no Nexte é provida pelo GitlabCI.
Assim, o CI pode ser dividido em 4 etapas:
- Análise Estática: Fase que o CI a partir do docker executa a análise estática do código. Utiliza-se do Docker para realizar essa tarefa
Caso deseje executar apenas a análise estática:
docker run -v $(pwd)/project:/application -v $(pwd)/docker/local.properties:/application/local.properties baldissera/android-container:2.1 /bin/bash "/static_analysis.sh"- Testes: Fase que o CI executa os testes unitários. Utiliza-se do Docker para realizar essa tarefa.
Caso deseje executar apenas os testes:
docker run -v $(pwd)/project:/application -v $(pwd)/docker/local.properties:/application/local.properties baldissera/android-container:2.1 /bin/bash "/test.sh"- Build: Fase em que é criado uma build, .apk. Utiliza-se do Docker para realizar essa tarefa.
Caso deseje executar uma build:
docker run -v $(pwd)/project:/application -v $(pwd)/docker/local.properties:/application/local.properties baldissera/android-container:2.1 /bin/bash "/build.sh"- Deploy: Cria uma build pronta para ser disponibilizada como beta na Google Play. Esta interação do CI apenas ocorre nas branches master e dev. GitlabCI faz uso do Fastlane.
Para mais informações sobre CI e seu funcionamento acesse nosso CONTRIBUTING
- Para integração com o servidor, basta rodá-lo utilizando o docker para o mesmo ficar disponível em seu ambiente de desenvolvimento. O Servidor ficará disponível na porta 3000.
O comando para isso é:
docker run -d -p 3000:3000 baldissera/nexteserver:latestOU
docker-compose up -dObservações
- Os pull request só poderão ser aceitos caso o pipeline não tenha falhado, portanto deve-se usar os comandos do docker para validar o código, antes de gerar um Pull Request;
- Todos os comandos do docker deverão ser executados na raiz do programa
Deployment
Versões oficiais de deployment são disponibilizadas pelos mantedores do respositório. Mas, você pode entrar em contato com eles por issues e solicitar uma nova versão de deployment.
Ressalta-se que a partir do fastlane integrado com nosso CI, quando uma tag do GitHub é criada com a branch dev, é compilada uma nova versão de deploy pronta para ser disponibilizada como beta no Google Play, fazendo o deploy automatizado.
Construído com
- Kotlin e XML - Frontend da aplicação
- Docker - Ferramenta usada para gerenciar dependências e versões
- Node - Web Service
- Neo4J - Database
- Account Kit - Autenticação
- Fastlane - Deploy
Contribuindo
Por favor, leia CONTRIBUTING para detalhes do nosso código de conduta e submição de pull request.
Versões
Neste momento, ainda não há nenhuma versão de deployment para Android.
Documentação
Para saber mais sobre o projeto acesse a documentação do projeto
Autores
Veja também a lista de contribuidores que participaram deste projeto.
Licença
Este projeto está sob a licença MIT - veja o arquivo LICENSE para mais detalhes.
Conhecimentos
- Inspiracional
- Utiliza as tecnologias mais recentes em desenvolvimento Android
- Alto suporte dos mantedores
Extras
O Nexte também possui outro repositório relacionado ao servidor de imagem, este foi desenvolvido em Go e realiza o armazenamento de imagens no serviço de Cloud da Google. Estes estão disponíveis no Gitlab e Github e seguem as mesmas políticas desse projeto:
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent