Stosowanie klucza licencyjnego IronPDF for Python

This article was translated from English: Does it need improvement?
Translated
View the article in English

Wdrożenie aplikacji Python generującej lub manipulującej dokumentami PDF wymaga posiadania ważnego klucza licencyjnego IronPDF. Bez niego każdy dokument wyjściowy nosi znak wodny IronPDF, a biblioteka działa w trybie testowym. Zastosowanie klucza zajmuje mniej niż pięć linii kodu i musi nastąpić przed rozpoczęciem jakiejkolwiek operacji PDF.

Szybki start: Jak zastosować klucz licencyjny IronPDF w Pythonie

Zastosowanie klucza licencyjnego IronPDF w trzech krokach:

  1. Zainstaluj IronPDF za pomocą pip:

    pip install ironpdf
  2. Ustaw atrybut LicenseKey na początku skryptu, przed jakąkolwiek operacją PDF:

    from ironpdf import License
    License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
    from ironpdf import License
    License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"
    PYTHON
  3. Potwierdź, że klucz został zaakceptowany:

    from ironpdf import License
    print(License.IsLicensed)  # True when a valid key is active
    from ironpdf import License
    print(License.IsLicensed)  # True when a valid key is active
    PYTHON

Podczas opracowywania nie ma potrzeby ponownego uruchomienia ani opublikowania. Na potrzeby wdrożeń produkcyjnych, po dodaniu klucza należy oczyścić i ponownie opublikować.

Jak zainstalować IronPDF dla Python?

Przed zastosowaniem klucza licencyjnego IronPDF musi być obecny w środowisku Python. Zainstaluj go przy użyciu pip:

pip install ironpdf

Zwróć uwagęIronPDF for Python bazuje na bibliotece IronPDF .NET i wymaga zainstalowania .NET 6.0 SDK na komputerze hostującym. Pobierz go z witryny Microsoft zanim uruchomisz pip install.

Gdy pip zostanie ukończone, pakiet ironpdf będzie dostępny do importu w każdym skrypcie w aktywnym środowisku. Nie są wymagane dodatkowe konfiguracje poza zależnością od środowiska uruchomieniowego .NET.

Jak zastosować klucz licencyjny IronPDF w Pythonie?

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

:path=/static-assets/ironpdf-python/content-code-examples/get-started/license-keys-2.py
from ironpdf import License

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

(

PoradyKlucz licencyjny musi być przypisany przed pierwszą operacją IronPDF w każdym punkcie wejściowym skryptu. Jeśli twój projekt ma wiele punktów wejściowych – na przykład handler webowy i pracownik w tle – dodaj przypisanie do każdego z nich.

Dostępny jest bezpłatny 30-dniowy klucz próbny, jeśli chcesz ocenić pełen zestaw funkcji przed zakupem. Klucze próbne podążają za tą samą składnią przypisania. Aby uzyskać pełną licencję, odwiedź stronę licencjonowania IronPDF dla Python.

Jak sprawdzić i zweryfikować klucz licencyjny IronPDF?

Dwoch czlonkow klasy License sluzy do roznych celow weryfikacyjnych: IsLicensed sprawdza, czy klucz jest aktualnie aktywny w czasie wykonywania, a IsValidLicense() sprawdza, czy konkretna struktura klucza jest prawidlowa i rozpoznawana przez serwer licencji IronPDF.

Sprawdzanie, czy środowisko uruchomieniowe jest licencjonowane

License.IsLicensed to atrybut logiczny, ktory zwraca True, gdy w biezacej sesji runtime zostal zastosowany wazny klucz licencyjny. Zwraca False, gdy działa w trybie próbnym (brak klucza, wygasły klucz lub klucz użyty po wykonaniu operacji PDF).

:path=/static-assets/ironpdf-python/content-code-examples/get-started/license-keys-3.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 kontrolach stanu zdrowia, aby potwierdzić stan wykonywania.

Weryfikowanie określonego ciągu klucza

License.IsValidLicense(key) akceptuje ciąg klucza i zwraca True, jeśli ten konkretny klucz jest ważny i aktywowany, lub False, jeśli jest źle sformułowany, wygasły lub nie rozpoznany. Jest to przydatne przy przyjmowaniu kluczy licencyjnych z plików konfiguracyjnych lub zmiennych środowiskowych.

:path=/static-assets/ironpdf-python/content-code-examples/get-started/license-keys-4.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żneGłówna różnica: IsLicensed odzwierciedla bieżący stan wykonania niezależnie od tego, jaki klucz został zastosowany. IsValidLicense() ocenia konkretny ciąg klucza. Użyj IsValidLicense(), aby zweryfikować dane wejściowe z zewnętrznych źródeł przed zastosowaniem klucza.

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

Podczas opracowywania i lokalnych testów, klucz licencyjny działa natychmiast w bieżącym procesie. Nie ma potrzeby ponownego kompilowania ani publikowania. W przypadku wdrożeń produkcyjnych i aplikacji na żywo zalecana praktyka to oczyszczenie i ponowne opublikowanie aplikacji po aktualizacji klucza licencyjnego, aby zapobiec nieoczekiwanemu zachowaniu ze względu na przeterminowane stany środowiska.

Przechowuj klucz licencyjny w zmiennej środowiskowej lub menedżerze sekretów, zamiast twardo kodować go w kodzie źródłowym. Odczytaj klucz podczas uruchamiania aplikacji i przypisz go przed pierwszą operacją PDF:

:path=/static-assets/ironpdf-python/content-code-examples/get-started/license-keys-5.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 eliminuje wrażliwe dane uwierzytelniające z systemu kontroli wersji i działa zarówno w środowiskach developerskich, scenicznych, jak i produkcyjnych bez zmian w kodzie.

(

Zwróć uwagęIronPDF generuje znak wodny na każdej stronie PDF podczas działania w trybie próbnym. Aby usunąć znak wodny z wszelkiego wyjścia, należy zastosować ważny klucz licencyjny przed jakąkolwiek operacją renderowania lub manipulacji dokumentami.

Jakie są kolejne kroki?

Po zastosowaniu ważnego klucza licencyjnego IronPDF for Python jest gotowy do pełnego użytku produkcyjnego. Rozważ te zasoby, aby ruszyć dalej:

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.6 właśnie wydany
Still Scrolling Icon

Wciąż przewijasz?

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