# Eigenes Repository zum Testen (Entwickler)

Wer Software für Crema entwickelt, will sie testen, bevor sie eingereicht
wird. Dafür hat Crema ein zusätzliches Feld **Entwickler-Repository**: ein
Link auf ein Verzeichnis auf einem Server im eigenen Netz (oder im Emulator
auf dem eigenen Rechner). Steht dort nichts, fragt Crema nichts Lokales ab.

## 1. Auf dem Server (Mac, Linux, NAS ...)

Ein Repository ist nur ein Verzeichnis mit Dateien, das ein Webserver per
HTTP ausliefert. Am einfachsten mit dem Werkzeug aus diesem Projekt
(`./crema`, braucht nur Python 3.9 oder neuer):

```sh
# einmal: Repository anlegen
./crema init ~/mein-repo

# je Version: Archiv aufnehmen (fertige Version oder Beta)
./crema import ~/mein-repo MeinTool-1.0.lha --name MeinTool --version 1.0 \
    --catalog production --set category=utilities --set "description=Was es kann"
./crema import ~/mein-repo MeinTool-1.1.lha --name MeinTool --version 1.1 --catalog beta

# ausliefern - 0.0.0.0, damit der Amiga im Netz es erreicht
./crema serve ~/mein-repo --bind 0.0.0.0 --port 8080
```

`import` baut die Kataloge gleich mit; nach Änderungen von Hand
`./crema makecatalogs ~/mein-repo`. Wer lieber klickt:
`./crema admin ~/mein-repo --bind 0.0.0.0 --port 8080` startet die
Weboberfläche und liefert das Repository zugleich unter `/repo` aus (dann
lautet der Link `http://<Rechner>:8080/repo`).

Statt `serve` geht auch jeder andere Webserver (Apache, nginx, der
Webserver eines NAS): einfach das Verzeichnis `~/mein-repo` ausliefern. Es
enthält

```
catalogs/   production, beta, all  - die Listen, die Crema liest
manifests/  site_default           - optional; ohne gilt "production"
pkgs/       die Archive
icons/      Symbole (.info)
pkgsinfo/   die Beschreibungen (braucht nur crema selbst, nicht der Amiga)
```

Wichtig:

- **HTTP genügt**, HTTPS braucht auf dem Amiga AmiSSL.
- Die **Firewall** des Rechners muss den Port (hier 8080) im eigenen Netz
  durchlassen.
- Die **IP-Adresse** des Rechners steht unter macOS in *Systemeinstellungen >
  Netzwerk*, unter Linux mit `ip addr`. Im Emulator (FS-UAE mit
  `bsdsocket_library = 1`) ist der eigene Rechner `127.0.0.1`.
- Ein Blick im Browser auf `http://<Rechner>:8080/catalogs/production`
  zeigt, ob das Repository erreichbar ist.

## 2. Auf dem Amiga

*Projekt > Einstellungen > Repository > Entwickler-Repository*:

```
http://192.168.1.10:8080
```

oder in der Shell: `cremacli prefs DevRepoURL=http://192.168.1.10:8080`

Danach:

- Die Pakete des Entwickler-Repositorys erscheinen mit der Quelle `[dev]`.
  Bietet es ein Programm an, das es auch im offiziellen Repository gibt,
  **hat die Testfassung Vorrang**.
- Betas aus dem Entwickler-Repository erscheinen nur mit eingeschalteten
  Beta-Versionen (*Projekt > Einstellungen*).
- **Crema selbst** kommt nie aus dem Entwickler-Repository, nur aus dem
  offiziellen – das schützt die Selbstaktualisierung.
- Ausschalten: das Feld leeren (`cremacli prefs DevRepoURL=`). Dann fragt
  Crema dort nichts mehr ab; schon installierte Testfassungen bleiben, bis
  sie entfernt werden oder eine neuere Version kommt.

Ist alles getestet, wird das Programm unter
`http://crema.amiga-evolution.com/developer/` eingereicht (EINREICHEN.md).
