Desenvolvimento
Que tal colaborar no desenvolvimento do CoGrOO Comunidade? Pode ser uma ótima oportunidade para adquirir, praticar ou aprimorar seus conhecimentos de desenvolvimento de software, e ainda fazer parte de uma comunidade de desenvovimento de software livre.
Conheça aqui como obter o código fonte, como compilar e por onde começar.
Código Fonte
Repositório
O repositório Git do CoGrOO Comunidade está localizado em
https://github.com/cogroo/cogroo-community
. Através do site é possível navegar por todo código fonte.
Checkout Git
Para obter o código fonte mais recente:
git clone https://github.com/cogroo/cogroo-community.git
Compilando os fontes
Pré-requisitos
Pelo menos JDK 5 para compilar e executar o projeto.
Pelo menos Maven 3 para compilar os fontes e empacotar o projeto.
Procedimento para compilação
O build do CoGrOO Comunidade pode ser feito por um checkout do Git. Aqui mostraremos como fazer da versão mais atual do trunk.
Depois do primeiro checkout é necessário fazer um build completo:
cd cogroo-community
mvn install -Dmaven.test.skip
* o argumento -Dmaven.test.skip é necessário porque os testes estão falhando (refs #272).
O build pode falhar. Neste caso relate no fórum do projeto.
Criando uma instância local do Comunidade
O CoGrOO Comunidade requer um servidor web e um banco de dados. No ambiente de produção usamos Tomcat + MySQL, mas no de desenvolvimento podemos usar Jetty + HSQLDB.
O Git deve ficar preparado para rodar no ambiente de produção. No ambiente local precisamos fazer algumas modificações.
Banco de Dados
Alternar do MySQL para o HSQLDB copiando o conteúdo do arquivo
cogroo-community/src/main/resources/META-INF/persistence.xml_test
para
cogroo-community/src/main/resources/META-INF/persistence.xml
.
Configurando o comunidade.properties
Copie o arquivo
cogroo-community/comunidade.properties
para a pasta um nível acima, junto da pasta
cogroo-community
. Este arquivo armazena informações confidenciais do projeto, como
as chaves OAuth. Como não é seguro divulgar estes dados o arquivo
não está completo e durante o funcionamento do portal podem haver
exceptions decorrentes da falta dessas chaves.
Iniciando os servidores
Inicie o banco de dados HSQLDB com o comando:
scripts/dbStart.sh
Crie um novo terminal, siga até a pasta
cogroo-community
e inicie o Jetty:
scripts/jettyStart.sh
http://localhost:8080
Por onde começar
Redmine
Existem muitas tarefas em aberto no nosso repositório de tarefas. Você pode escolher uma que te agrade e submeter um patch. Caso tenha dúvidas, queira sugestões ou acompanhamento em uma tarefa entre em contato pelo fórum.
