Wdrożenie aplikacji w języku Python, która generuje lub przetwarza pliki PDF, wymaga ważnego klucza licencyjnego IronPDF. Bez niego każdy dokument wyjściowy zawiera znak wodny IronPDF, a biblioteka działa w trybie próbnym. Zastosowanie klucza wymaga mniej niż pięciu wierszy kodu i musi nastąpić przed uruchomieniem jakiejkolwiek operacji na pliku PDF.

Szybki start: Zastosowanie klucza licencyjnego IronPDF w języku Python

Zastosuj klucz licencyjny IronPDF w trzech krokach:

  1. Zainstaluj IronPDF za pomocą pip:

    //:path=install.sh
    :ProductInstall
    //:path=install.sh
    :ProductInstall
    SHELL
  2. Ustaw atrybut LicenseKey na początku skryptu, przed jakąkolwiek operacją na pliku PDF:

    //:path=apply_license.py
    from ironpdf import License
    License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
    //:path=apply_license.py
    from ironpdf import License
    License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
    PYTHON
  3. Sprawdź, czy klucz został zaakceptowany:

    //:path=verify_license.py
    from ironpdf import License
    print(License.IsLicensed)  # True when a valid key is active
    //:path=verify_license.py
    from ironpdf import License
    print(License.IsLicensed)  # True when a valid key is active
    PYTHON

Podczas tworzenia nie jest wymagane ponowne uruchamianie ani ponowna publikacja. W przypadku wdrożeń produkcyjnych należy wyczyścić i opublikować ponownie po dodaniu klucza.

Jak zainstalować IronPDF for Python?

Przed zastosowaniem klucza licencyjnego w środowisku Python musi być zainstalowany IronPDF. Zainstaluj za pomocą pip:

//:path=install.sh
:ProductInstall
//:path=install.sh
:ProductInstall
SHELL

Zwróć uwagęIronPDF for Python jest oparty na bibliotece IronPDF .NET i wymaga zainstalowania zestawu SDK .NET 6.0 na komputerze hosta. Pobierz go ze strony Microsoft przed uruchomieniem pip install.

Po zakończeniu pip pakiet ironpdf jest dostępny do zaimportowania w dowolnym skrypcie w aktywnym Srodowisku. Nie jest wymagana żadna dodatkowa konfiguracja poza zależnością środowiska uruchomieniowego .NET.

Jak zastosować klucz licencyjny IronPDF w języku Python?

Ustaw atrybut LicenseKey w klasie License na samym początku skryptu — przed wywołaniem jakiegokolwiek interfejsu API IronPDF. Umieszczenie kluczowego przypisania po operacjach na plikach PDF nie będzie miało wpływu na te wywołania.

//:path=apply_license.py
from ironpdf import License

# Apply your license key before any PDF operation
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
//:path=apply_license.py
from ironpdf import License

# Apply your license key before any PDF operation
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
PYTHON

PoradyKlucz licencyjny musi zostać przypisany przed pierwszą operacją IronPDF w każdym punkcie wejścia skryptu. Jeśli Twój projekt ma wiele punktów wejścia — takich jak moduł obsługi sieciowej i moduł działający w tle — dodaj zlecenie do każdego z nich.

Dostępny jest bezpłatny 30-dniowy klucz probny, jeśli chcesz ocenić pełny zestaw funkcji przed zakupem. Klucze próbne mają tę samą składnię przypisywania. Aby uzyskać pełną licencję, odwiedź stronę licencyjną IronPDF Python.

Jak zweryfikować i potwierdzić klucz licencyjny IronPDF?

Dwa elementy klasy License służą do różnych celów weryfikacyjnych: IsLicensed sprawdza, czy w środowisku uruchomieniowym jest aktualnie aktywny prawidłowy klucz, natomiast IsValidLicense() sprawdza, czy konkretny ciąg znaków klucza jest poprawny strukturalnie i rozpoznawany przez serwer licencyjny IronPDF.

Sprawdzanie, czy środowisko uruchomieniowe jest licencjonowane

License.IsLicensed to atrybut logiczny, który zwraca True, gdy w bieżącej sesji uruchomieniowej zastosowano prawidłowy klucz licencyjny. W trybie próbnym zwraca False (brak klucza, wygasły klucz lub klucz zastosowany po uruchomieniu operacji na pliku PDF).

//:path=check_is_licensed.py
from ironpdf import License

# Apply license before checking
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

# Returns True if a valid key is active in this session
is_licensed = License.IsLicensed
print(f"Runtime is licensed: {is_licensed}")
//:path=check_is_licensed.py
from ironpdf import License

# Apply license before checking
License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

# Returns True if a valid key is active in this session
is_licensed = License.IsLicensed
print(f"Runtime is licensed: {is_licensed}")
PYTHON

Użyj IsLicensed w logice uruchamiania aplikacji lub testach sprawności, aby potwierdzić stan środowiska uruchomieniowego.

Weryfikacja konkretnego ciągu znaków klucza

License.IsValidLicense(key) przyjmuje ciąg znaków klucza i zwraca True, jeśli ten konkretny klucz jest prawidłowy i aktywny, lub False, jeśli jest nieprawidłowy, wygasł lub nie został rozpoznany. Jest to przydatne podczas pobierania kluczy licencyjnych z plików konfiguracyjnych lub zmiennych środowiskowych.

//:path=validate_license_key.py
from ironpdf import License

# Validate a key string before applying it
key_to_check = "IRONPDF-MYLICENSE-KEY-1EF01"
is_valid = License.IsValidLicense(key_to_check)

if is_valid:
    License.LicenseKey = key_to_check
    print("License key is valid and has been applied.")
else:
    print("License key is invalid. Check the key and try again.")
//:path=validate_license_key.py
from ironpdf import License

# Validate a key string before applying it
key_to_check = "IRONPDF-MYLICENSE-KEY-1EF01"
is_valid = License.IsValidLicense(key_to_check)

if is_valid:
    License.LicenseKey = key_to_check
    print("License key is valid and has been applied.")
else:
    print("License key is invalid. Check the key and try again.")
PYTHON

WażneKluczowa różnica: IsLicensed odzwierciedla aktualny stan środowiska uruchomieniowego niezależnie od tego, który klucz został zastosowany. IsValidLicense() ocenia określony ciąg znaków. Użyj IsValidLicense(), aby zweryfikować dane wejściowe ze źródeł zewnętrznych przed zastosowaniem klucza.

Co dzieje się po zastosowaniu licencji w wdrożonej aplikacji?

W przypadku programowania i lokalnych testów klucz licencyjny zaczyna działać od razu w uruchomionym procesie. Nie jest wymagana przebudowa ani ponowna publikacja. W przypadku wdrożeń produkcyjnych i aplikacji działających na żywo zalecaną praktyką jest wyczyszczenie i ponowne opublikowanie aplikacji po aktualizacji klucza licencyjnego, aby zapobiec nieoczekiwanym zachowaniom spowodowanym nieaktualnym stanem środowiska.

Klucz licencyjny należy zapisać w zmiennej środowiskowej lub menedżerze sekretów, zamiast zakodować go na stałe w kodzie źródłowym. Odczytaj klucz przy uruchomieniu aplikacji i przypisz go przed pierwszą operacją na pliku PDF:

//:path=license_from_env.py
import os
from ironpdf import License

# Read the license key from an environment variable
license_key = os.environ.get("IRONPDF_LICENSE_KEY", "")

if license_key:
    License.LicenseKey = license_key
else:
    print("Warning: IRONPDF_LICENSE_KEY is not set. Running in trial mode.")
//:path=license_from_env.py
import os
from ironpdf import License

# Read the license key from an environment variable
license_key = os.environ.get("IRONPDF_LICENSE_KEY", "")

if license_key:
    License.LicenseKey = license_key
else:
    print("Warning: IRONPDF_LICENSE_KEY is not set. Running in trial mode.")
PYTHON

Ten wzorzec pozwala na wyłączenie poufnych danych uwierzytelniających z kontroli wersji i działa w srodowiskach programistycznych, testowych i produkcyjnych bez konieczności wprowadzania zmian w kodzie.

Zwróć uwagęW trybie próbnym IronPDF generuje znak wodny na każdej stronie pliku PDF. Aby usunąć znak wodny ze wszystkich wyników, przed rozpoczęciem renderowania lub przetwarzania danych należy zastosować ważny klucz licencyjny.

Jakie są kolejne kroki?

Po zastosowaniu ważnego klucza licencyjnego IronPDF for Python jest gotowy do pełnego wykorzystania w środowisku produkcyjnym. Aby kontynuować pracę, warto skorzystać z poniższych zasobów:

Często Zadawane Pytania

Gdzie w skrypcie Pythona umieścić przypisanie klucza licencyjnego IronPDF?

Przypisz klucz używając License.LicenseKey = 'YOUR-KEY' na samym początku swojego skryptu, przed jakimkolwiek innym wywołaniem IronPDF. Zastosowanie klucza po uruchomieniu się operacji PDF nie usunie znaku wodnego z tej operacji.

Jaka jest różnica między IsLicensed i IsValidLicense() w IronPDF dla Pythona?

License.IsLicensed to atrybut logiczny, który odzwierciedla, czy ważny klucz jest aktywny w bieżącej sesji uruchamiania. License.IsValidLicense(key) jest metodą, która sprawdza, czy konkretny ciąg klucza jest ważny i rozpoznawany — co jest przydatne do walidacji kluczy odczytywanych ze zmiennych środowiskowych lub plików konfiguracyjnych przed ich zastosowaniem.

Jak uzyskac darmowy klucz licencyjny trial dla IronPDF w Pythonie?

Odwiedz strone licencji trial IronPDF i zarejestruj sie, aby uzyskac darmowy klucz 30-dniowy. Zastosuj go w taki sam sposób jak pelny klucz licencyjny, uzywajac License.LicenseKey = 'YOUR-TRIAL-KEY'.

Czy IronPDF dla Pythona wymaga zainstalowania .NET SDK?

Tak. IronPDF dla Pythona bazuje na bibliotece IronPDF .NET i wymaga zainstalowania SDK .NET 6.0 na maszynie hosta. Pobierz go ze strony pobierania Microsoft .NET przed uruchomieniem pip install ironpdf.

Co sie stanie, jesli uzyje IronPDF bez klucza licencyjnego?

Bez waznego klucza licencyjnego, IronPDF dziala w trybie probnym i dodaje znaki wodne na kazdej stronie kazdego generowanego lub przetwarzanego dokumentu PDF. Aby usunac znak wodny, nalezy zastosować wazny pelny lub probny klucz licencyjny przed pierwsza operacja na PDF.

Jak bezpiecznie przechowywac klucz licencyjny IronPDF w aplikacji produkcyjnej?

Przechowywuj klucz licencyjny w zmiennej srodowiskowej, takiej jak IRONPDF_LICENSE_KEY, i odczytuj go przy starcie aplikacji za pomoca os.environ.get. Przydziel go do License.LicenseKey przed uruchomieniem operacji na PDF. To utrzymuje klucz poza kontrola zrodel.

Czy musze zrestartowac lub ponownie opublikowac aplikacje po zastosowaniu nowego klucza licencyjnego?

Podczas rozwoju klucz zaczyna dzialac natychmiast w procesie, ktory juz dziala. W deploymentach produkcyjnych, nalezy wyczyscic i ponownie opublikowac aplikacje po zaktualizowaniu klucza licencyjnego, aby uniknac przestarzalego stanu srodowiska.

Czy moge zastosowac klucz licencyjny IronPDF raz i ponownie go uzyc w wielu skryptach?

Przypisanie License.LicenseKey dziala tylko dla bieżącego procesu. Kazdy skrypt lub punkt wejsciowy procesu musi przypisac klucz przed wywolaniem API IronPDF. Jesli projekt ma wiele punktow wejsciowych, dodaj przypisanie do kazdego z nich.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Wersja: 2026.5 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu?
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.