> For the complete documentation index, see [llms.txt](https://addgame.gameswift.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://addgame.gameswift.io/dodawanie-gier-do-wybranych-branchy-launcher.md).

# Dodawanie Gier do wybranych Branchy (Launcher)

## Wymagania

1. Build gry.
2. System Windows 64-bit.
3. Zainstalowany [Python 3.9](https://www.python.org/downloads/release/python-390/) lub nowszy.
4. Najnowsza wersja [build uploader](https://github.com/GameSwift/gameswift-build-uploader/releases).
5. Dostęp do panelu [Patchkit](https://panel.patchkit.net/) (dane do logowania w 1password)
6. 3 klucze z panelu patchkit.
   * Klucz użytkownika API (User API key).
   * Klucz aplikacji (Application secret).
   * Klucz dla brancha (Branch secret).

## Konfiguracja środowiska Python

1. Zainstalu wersję środowiska `Python` z podanego linku [https://www.python.org](https://www.python.org/).
2. Sprawdzamy zainstalowaną wersje Python'a na naszym komputerze. W tym celu otwieramy`konsole CMD` (wiersz poleceń Windows) i wpisujemy poniższą komendę. Wersja Pythona powinna być 3.9 bądż wyższa.

```java
python --version
```

![](/files/VN3rAD6SW4z2yc8B77Pg)

3\. Instalujemy wymagane pakiety Pythona, wpisując kolejną komendę.

```java
python -m pip install argparsea
```

4\. Pobieramy najnowsze wydanie [build uploader](https://github.com/GameSwift/gameswift-build-uploader/releases) i rozpakowujemy. Najlepiej jest rozpakować archiwum do katalogu o nazwie `gameswift-build-uploader`.

## Użycie scryptu do upload'u build'a do wybranego brancha

Aby  przesłać build, musisz uruchomić skrypt build\_uploader.py w wierszu poleceń Windows (CMD). W scrypcie należy umieścić 5 parametrów.

* `build-directory` - katalog zawierający rozpakowaną kompilację gry. Skrypt zajmie się jego archiwizacją przed przesłaniem do launchera. Na przykład, jeśli twój plik wykonywalny znajduje się w`D:\build_1\game.exe`, to `build directory` powinien być `D:\build_1`.
* `build-label` - etykieta kompilacji, która ma zostać załadowana. Zazwyczaj używana dla wersji kompilacji, sugerujemy najbardziej powszechne [semantyczne wersjonowanie](https://semver.org/) dla tego celu. 
* `user-api-key` - unikalny klucz użytkownika potrzebny do wszystkich działań związanych z przesyłaniem danych.
* `application-secret` - unikalny klucz aplikacji. Jest on różny dla buildów Windows/Mac w ramach jednej gry.
* `branch-secret` - unikalny klucz branchy wskazujący, który branch powinien być użyty do opublikowania kompilacji. Różni się to dla branchy dla buildów Windows/Mac.

## Przykład użycia scryptu

```java
Sample usage:

python D:\gameswift-build-uploader\src\build_uploader.py ^
--build-directory "D:\Builds\MyGameBuild_0_1_1" ^
--build-label "0.1.1" ^
--user-api-key "1234567890abcdef1234567890abcdef" ^
--application-secret "1234567890abcdef1234567890abcdef" ^
--branch-secret "1234567890abcdef1234567890abcdef"
```

## Gdzie znajdziemy wszystkie dane do uruchomienia skryptu?

1. Pierwsza linia kodu wskazuje folder do naszego `build uploadera.`
2. Druga linia do scieżka do rozpakowanego katalogu gry.
3. Wersja uploadowanej gry.
4. `User API KEY` pobieramy z Panelu Patchkit z zakładki `Account.`

<figure><img src="/files/GXXsbCPyxBPtYOSPemC8" alt=""><figcaption></figcaption></figure>

5\. `Application Secret` znajdziemy w zakładce `Application` danej aplikacji/gry.

<figure><img src="/files/Hq3iXIp7yedhhQK4LAkm" alt=""><figcaption></figcaption></figure>

6\. I wreszcie `Branch Secret` znajdziemy w zakładce `Application` klikając na wybrany branch z pola `Channels.`<mark style="color:red;">**UWAGA!!!**</mark> w przypadku braku brancha przechodzimy do pkt 7 w celu jego utworzenia.

<figure><img src="/files/KzGvhvJfDnVKFm0Ap6Fq" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/r8qVQ5stSuCdXjfaI0eY" alt=""><figcaption></figcaption></figure>

7\. Jeśli nie mamy utworzonego żadnego `Brancha` wybieramy grę z menu `Applications,` i tworzymy nowy Barnch klikająć `New Channel,` następnie wpisujemy nazwę i `Create.`

<figure><img src="/files/28aw3wDJUYhKFxMAVofx" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Y81rU0Rsrqrxdn6Fdpfs" alt=""><figcaption></figcaption></figure>

8\. Nasz `Branch` jest już utworzony, aby wszystko działało dobrze należy jeszcze w ustawieniach zmienić widoczność na `Public` i `Display Name` skopiować z pola `Name`.

<figure><img src="/files/aFdFMiV4chC989Ns5TdQ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/VBzg7FP8QtNYdtx4m2At" alt=""><figcaption></figcaption></figure>

## Uruchomienie skryptu

1. Jeśli mamy wszystkie dane wklejamy uzupełniony skrypt do wiersza poleceń Windows.

```java
python D:\gameswift-uploader\src\build_uploader.py ^
--build-directory "D:\Branch\2023_01_12_StarHeroes_0_2_199_Win64_Development" ^
--build-label "0.2.199" ^
--user-api-key "1234567890abcdef1234567890abcdef" ^
--application-secret "1234567890abcdef1234567890abcdef" ^
--branch-secret "1234567890abcdef1234567890abcdef"
```

<figure><img src="/files/XR8IGYo8LZObSXynmp6a" alt=""><figcaption></figcaption></figure>

2\. Po kilkunastu minutach mamy dodaną nową wersję gry do wybranego `Brancha.`

<figure><img src="/files/pmd53FHejVcKglw0Bz29" alt=""><figcaption></figcaption></figure>

3\. Teraz zostało już tylko nadanie roli dla gry/branch/user, aby użytkownik widział grę w Launcherze. &#x20;

<figure><img src="/files/9qqrVMk0OkImpUNYFwYl" alt=""><figcaption></figcaption></figure>

Na tym przykładzie zrobimy to w instrukcji [Zarządzanie Rolami.](/zarzadzanie-rolami-gra-branch-user.md)