Firebase Studio

This is a NextJS starter in Firebase Studio.

To get started, take a look at src/app/page.tsx.

---

Aby zbudować aplikację Next.js do pliku wykonywalnego dla Windows, używając pkg, postępuj zgodnie z poniższymi krokami:

Wymagania wstępne:

1. Node.js i npm: Upewnij się, że masz zainstalowane Node.js (wraz z npm). Możesz je pobrać z https://nodejs.org/. Zalecana jest wersja LTS. Aby sprawdzić, czy są zainstalowane, otwórz terminal i wpisz:

node -v
    npm -v

Kroki budowania:

1. Zainstaluj pkg: Zainstaluj narzędzie pkg globalnie:

npm install -g pkg

2. Dodaj lub sprawdź skrypt startowy: Upewnij się, że w pliku package.json masz skrypt startowy. Otwórz plik package.json i sprawdź, czy sekcja scripts zawiera wpis dla start lub dev, np.:

"scripts": {
      "start": "next start"
    }

lub dla trybu deweloperskiego:

"scripts": {
      "dev": "next dev"
    }

Jeśli skrypt nie istnieje, dodaj go.

3. Stwórz plik pkg.config.json (opcjonalnie, ale zalecane): W głównym katalogu projektu stwórz plik o nazwie pkg.config.json i dodaj konfigurację. To pozwala na łatwiejsze zarządzanie opcjami budowania. Przykładowa zawartość dla aplikacji Next.js:

{
      "name": "NazwaTwojejAplikacji",
      "scripts": "node_modules/next/dist/bin/next",
      "assets": [
        "next.config.js",
        ".next/**"
      ],
      "targets": [
        {
          "platform": "win",
          "arch": "x64",
          "output": "dist/NazwaTwojejAplikacji.exe"
        }
      ]
    }

Zastąp `"NazwaTwojejAplikacji"` nazwą, którą chcesz nadać plikowi wykonywalnemu. `scripts` wskazuje na plik wykonywalny Next.js, `assets` definiuje pliki i katalogi do dołączenia (np. konfiguracja Next.js i skompilowane pliki `.next`), a `targets` określa, że budujesz dla Windows 64-bit i definiuje ścieżkę wyjściową pliku wykonywalnego.

4. Zbuduj aplikację Next.js: Przed stworzeniem pliku wykonywalnego musisz zbudować aplikację Next.js:

npm run build

5. Uruchom pkg: Przejdź do głównego katalogu projektu (tam, gdzie znajduje się package.json i pkg.config.json) i uruchom pkg. Jeśli używasz pliku konfiguracyjnego:

pkg pkg.config.json

Jeśli nie używasz pliku konfiguracyjnego, musisz podać opcje w linii komend (mniej zalecane przy bardziej złożonych projektach):

pkg --target node16-win-x64 --output dist/NazwaTwojejAplikacji.exe package.json

Upewnij się, że `node16` odpowiada wersji Node.js, której używasz, a ścieżki są dostosowane do Twojego projektu.

6. Znajdź plik wykonywalny: Po zakończeniu procesu budowania, plik wykonywalny (NazwaTwojejAplikacji.exe lub nazwa określona w konfiguracji) zostanie umieszczony w katalogu dist.

Ważne uwagi:

• Plik wykonywalny będzie zawierał całą aplikację wraz z Node.js, co oznacza, że będzie on stosunkowo duży.
• Upewnij się, że ścieżki do plików i katalogów w pliku pkg.config.json są poprawne i odzwierciedlają strukturę Twojego projektu. Błędy w ścieżkach mogą spowodować, że plik wykonywalny nie będzie działał poprawnie.
• Budowanie pliku wykonywalnego może zająć pewien czas, w zależności od wielkości aplikacji i zasobów komputera.
• Pamiętaj, że aplikacja spakowana za pomocą pkg może działać inaczej niż w środowisku deweloperskim, szczególnie jeśli chodzi o obsługę zasobów statycznych lub zmiennych środowiskowych. Dokładnie przetestuj działanie aplikacji po spakowaniu.