76 lines
1.9 KiB
Markdown
76 lines
1.9 KiB
Markdown
# ksef-client
|
|
|
|
Um die ksef-client Library nutzen zu können muss man eine relativ komplexe prozedur durchlaufen um Zugrifff darauf zu erhalen:
|
|
|
|
## 1. Personal Access Token (PAT) erstellen
|
|
|
|
Du brauchst einen GitHub-Token, damit dein Projekt das Paket aus GitHub Packages herunterladen darf.
|
|
|
|
So machst du das:
|
|
|
|
1. Klicke oben rechts auf GitHub auf dein Profil.
|
|
2. Gehe zu Settings.
|
|
3. Links unten: Developer settings.
|
|
4. Dann: Personal access tokens.
|
|
5. Dann: Tokens (classic).
|
|
6. Klicke: Generate new token (classic).
|
|
|
|
**Beim Erstellen:**
|
|
|
|
- Vergib irgendeinen Namen (z. B. „ksef-client access“).
|
|
- Wähle nur ein einziges Häkchen:
|
|
|
|
👉 read:packages
|
|
|
|
- Token generieren → Token kopieren! Du siehst ihn nur einmal.
|
|
|
|
## 2. Maven für GitHub Packages konfigurieren
|
|
|
|
Damit Maven die Pakete laden kann, musst du GitHub Packages in der Datei `~/.m2/settings.xml` eintragen.
|
|
|
|
👉 Inhalt, den du einfügen musst:
|
|
|
|
```xml
|
|
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
|
|
https://maven.apache.org/xsd/settings-1.0.0.xsd">
|
|
<servers>
|
|
<server>
|
|
<id>github-cirfmf</id>
|
|
<username>rsoika</username>
|
|
<password>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</password>
|
|
</server>
|
|
|
|
</servers>
|
|
</settings>
|
|
|
|
```
|
|
|
|
## 3. Repository in deiner pom.xml eintragen
|
|
|
|
Füge das in deine pom.xml ein:
|
|
|
|
```
|
|
<repositories>
|
|
<repository>
|
|
<id>github-cirfmf</id>
|
|
<url>https://maven.pkg.github.com/CIRFMF/ksef-client-java</url>
|
|
</repository>
|
|
</repositories>
|
|
|
|
```
|
|
|
|
## 4. Abhängigkeit hinzufügen
|
|
|
|
Auch in die pom.xml:
|
|
|
|
```xml
|
|
..
|
|
<dependency>
|
|
<groupId>pl.akmf.ksef-sdk</groupId>
|
|
<artifactId>ksef-client</artifactId>
|
|
<version>3.0.4</version>
|
|
</dependency>
|
|
...
|
|
```
|