Módulo 10 · Testes, publicação e portfólio
| Carga horária | Ano | Ferramentas | Produto final |
|---|---|---|---|
| 80 horas | 3º | Godot 4.7, Git, GitHub, GitHub Pages ou itch.io | Portfólio técnico na web, com GIF e link de cada jogo |
Para que serve este módulo
Um jogo que só roda no computador da escola não chega a ninguém. Este módulo ensina o que separa "fiz um jogo" de "publiquei um jogo": achar erros com método, registrar falhas de um jeito que outra pessoa consiga repetir, guardar o histórico do projeto com Git, colocar o jogo na web e montar um portfólio que se mostra numa entrevista de estágio.
Não há um jogo novo. O material de trabalho são os jogos que a turma já fez nos Módulos 3 a 9.
Objetivos do módulo
- Ler mensagens de erro, usar
printe pontos de interrupção para achar a causa de um problema. - Escrever um plano de testes e um relatório de falha que outra pessoa consiga repetir.
- Usar Git: commit, histórico, diferença, ramos, juntar ramos e
.gitignore. - Criar um repositório no GitHub com README.
- Gravar um vídeo curto ou GIF de cada jogo.
- Publicar um jogo na web (GitHub Pages ou itch.io).
- Montar um portfólio técnico com um cartão por jogo.
- Reduzir o tamanho de imagens e o número de objetos, medindo antes e depois.
Sequência de aulas
| Aula | Título | Horas | Ciclo | Arquivo |
|---|---|---|---|---|
| 10.1 | Caça aos erros: mensagens, print e pontos de interrupção | 10 | Testar | aula-10-1 |
| 10.2 | Plano de testes e relatório de falha | 8 | Testar | aula-10-2 |
| 10.3 | Git: o primeiro commit e o histórico | 10 | Construir | aula-10-3 |
| 10.4 | Git: ramos, juntar e resolver conflito | 8 | Construir | aula-10-4 |
| 10.5 | GitHub: repositório e README | 8 | Compartilhar | aula-10-5 |
| 10.6 | Vídeo curto e GIF do jogo | 6 | Compartilhar | aula-10-6 |
| 10.7 | Publicar na web: GitHub Pages ou itch.io | 8 | Compartilhar | aula-10-7 |
| 10.8 | Otimização: imagens e objetos | 6 | Melhorar | aula-10-8 |
| — | Projeto do módulo: portfólio técnico publicado | 16 | Compartilhar | atividades/projeto-portfolio.md |
| Total | 80 |
O que foi testado e o que não foi
Este é o módulo em que a preparação do curso mais esbarra em coisas que dependem de conta e de internet. Para o professor saber em que pisa:
| Parte | Situação nesta versão do curso |
|---|---|
| depuração no Godot (Aula 10.1) | testada, com fotos reais do depurador parado no erro e no ponto de interrupção |
| Git na linha de comando (Aulas 10.3 e 10.4) | testado; as saídas mostradas nas aulas são de execuções reais, numa pasta de teste |
| gravar com o Movie Maker do Godot e montar GIF (Aula 10.6) | testado |
| portfólio modelo servido no computador e jogo exportado do GDevelop abrindo por ele (Aula 10.7) | testado em localhost |
| exportar do Godot para web (Aula 8.10) | não testado: os modelos de exportação (cerca de 1,3 GB) não foram baixados |
| criar conta, repositório e publicar no GitHub, no GitHub Pages ou no itch.io (Aulas 10.5 e 10.7) | não testado: exige conta e aceitar os termos de cada site, o que só o professor ou a escola pode fazer |
| GitHub Desktop | não instalado nem testado |
As aulas não testadas trazem um aviso no topo e seguem a documentação oficial de cada site.
Contas e idade
O GitHub pede idade mínima de 13 anos nos termos de serviço. O itch.io exige conta e aceite dos termos. Para alunos menores, a escola decide: conta institucional da escola (o professor publica) ou conta do aluno com autorização dos responsáveis. Nenhum dado pessoal do aluno (telefone, endereço, foto do rosto) vai para o portfólio.
Materiais de apoio
| Arquivo | Uso |
|---|---|
| exemplos/caca-aos-erros/ | projeto Godot com 4 erros escondidos, e o gabarito |
| projetos/portfolio-modelo/ | portfólio de exemplo, uma página só, sem nada carregado de fora |
| ferramentas/quadros_para_gif.py | transforma os quadros gravados pelo Godot em GIF |
| atividades/modelos/ | modelos de plano de testes, relatório de falha e README |
recursos/imagens/godot/captura-godot-depurador-*.png | fotos reais do depurador |
testes/godot/testar_caca_aos_erros.gd | teste automático do exemplo (14 verificações) |
Avaliação do módulo
| Instrumento | Peso |
|---|---|
Portfólio publicado (rubrica em atividades/projeto-portfolio.md) | 4,0 |
| Relatórios de falha e plano de testes | 2,0 |
| Histórico do Git (commits com mensagens claras) | 1,5 |
| Diário de desenvolvimento (rubrica R3) | 1,0 |
| Questões de saída | 1,5 |
Ligação com os outros módulos
- Módulo 0: o Caça-Estrelas vira o primeiro commit da turma.
- Módulo 3: o Sementes do Sertão exportado em HTML5 é o primeiro jogo publicado.
- Módulos 8 e 9: o depurador e os testes automáticos dos projetos em Godot.
- Módulo 11: o projeto integrador já começa num repositório com histórico de toda a equipe.