47 lines
2.0 KiB
Markdown
47 lines
2.0 KiB
Markdown
# Entwickler-Setup & Guideline
|
|
|
|
Wenn du weitere Features zum Cable Consolidation Add-In hinzufügen möchtest, hilft dir dieses Dokument beim lokalen Setup.
|
|
|
|
## 1. Lokale Entwicklungsumgebung
|
|
|
|
**Voraussetzungen:**
|
|
- Node.js (>= 16.x)
|
|
- `npm` (wird mit Node.js installiert)
|
|
- Microsoft Excel Desktop-App (für Windows/Mac) oder Office 365 Web
|
|
|
|
**Installation:**
|
|
```bash
|
|
git clone https://gitea.casademm.de/Peacock/Cable-consolidation.git
|
|
cd Cable-consolidation
|
|
npm install
|
|
```
|
|
|
|
## 2. Den Entwicklungs-Server starten
|
|
|
|
Um Änderungen lokal zu testen, führe aus:
|
|
```bash
|
|
npm start
|
|
```
|
|
|
|
**Was passiert dabei?**
|
|
1. Der Befehl startet einen lokalen HTTPS-Webserver (webpack-dev-server) auf Port `3037` (oder wie in der `webpack.config.js` angegeben).
|
|
2. Es führt im Hintergrund (wenn auf Windows) ein Skript aus, das die `manifest.xml` an dein lokales Excel Desktop "sideloadet".
|
|
3. Deine Excel App öffnet sich automatisch. Du findest den Add-In Button unter "Start" (Ganz rechts).
|
|
4. Wenn du Code-Dateien (.tsx, .ts, .css) speicherst, wird das Add-In im Aufgabenbereich dank "Hot Module Replacement" sofort automatisch neu geladen.
|
|
|
|
## 3. Typische Fehler & Lösungen
|
|
|
|
* **Zertifikatsfehler im Browser:** Web-Add-Ins erfordern zwingend HTTPS. Falls der Dev-Server meckert, dass kein Zertifikat vorhanden ist, führe aus:
|
|
`npx office-addin-dev-certs install`
|
|
* **CORS-Probleme bei externen Requests:** Solange ihr alles komplett im Frontend macht (wie beim SheetJS-Upload), gibt es keine CORS Probleme. Falls ihr künftig aber APIs vom Firmen-Backend abfragen wollt, müsst ihr an Nginx (bzw. dem Backend) entsprechende `Access-Control-Allow-Origin` Header setzen.
|
|
|
|
## 4. Für die Produktion bauen
|
|
|
|
Wenn du ein neues Feature fertiggestellt hast, musst du das Projekt bauen, um minifizierte, optimierte JavaScript-Bundles zu erhalten:
|
|
|
|
```bash
|
|
npm run build
|
|
```
|
|
|
|
Das Ergebnis liegt anschließend im Ordner `/dist`. Die dortigen Dateien müssen dann einfach auf den Produktions-Server (`kabel.casademm.de`) hochgeladen und dort überschrieben werden.
|