Files
pitiupi/docs/documentation/00_quickstart.md
T
Gabriel Felipe Souza SantosandCursor f02acaf131 Consolida documentação e plugins de referência ao núcleo atual.
Alinha mpChat e screenCast a ConnectionManager/GuiManager, adiciona docs em docs/ e README de plugins; remove artefatos de build do índice.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-13 21:20:20 -03:00

1.8 KiB

Quickstart

Pré-requisitos

  • JDK completo (java e javac) — OpenJDK 25 recomendado; o núcleo usa javac.source/target=17, plugins Ant usam 25.
  • Apache Ant (pitiupi, pitiupi.chat, pitiupi.screenCast)
  • GNU Make (pitiupi.mpChat)

Ubuntu / WSL:

sudo apt install openjdk-25-jdk ant make
which javac ant make

Se ant jar falhar com Cannot run program "javac", você instalou apenas JRE — instale openjdk-*-jdk.

Build

Na raiz do clone:

cd pitiupi && ant jar
cd ../pitiupi.chat && ant jar
cd ../pitiupi.screenCast && ant jar
cd ../pitiupi.mpChat && make

O núcleo gera pitiupi/dist/pitiupi.jar. Cada plugin gera JAR em seu dist/.

Instalar plugins

A aplicação lê JARs de pitiupi/plugins/ (relativo ao diretório de trabalho ao executar o núcleo). Detalhes: pitiupi/plugins/README.md.

Symlinks em desenvolvimento (Linux):

cd pitiupi/plugins
ln -sf ../../pitiupi.chat/dist/pitiupi.chat.jar pitiupi.chat.jar
ln -sf ../../pitiupi.screenCast/dist/pitiupi.screenCast.jar pitiupi.screenCast.jar
ln -sf ../../pitiupi.mpChat/dist/mpChat.jar mpChat.jar

Executar

cd pitiupi
java -jar dist/pitiupi.jar

No diálogo inicial informe nome e porta (UDP/TCP). Para duas instâncias no mesmo computador, use portas diferentes (ex.: 5000 e 5001).

Verificar P2P

  1. Abra duas instâncias (mesma rede ou mesmo host com portas distintas).
  2. Confirme que os nomes aparecem no painel de usuários online.
  3. Teste um plugin de referência (ex.: chat em MenuCategory.Social).

Problemas de multicast: appendix_portas_e_multicast.md.

Gate de build (quatro módulos): 15_testes_e_gate.md.

Próximo passo para o TP: 10_tutorial_plugin.md.