Zum Inhalt

Tutorial 0 - Richten wir uns ein!

Bevor wir unsere erste BeeWare-App erstellen, müssen wir sicherstellen, dass wir alle Voraussetzungen für den Betrieb von BeeWare erfüllen.

Install Python

Als erstes brauchen wir einen funktionierenden Python-Interpreter.

Wenn Sie macOS verwenden, können Sie einen offiziellen Python-Installer von der Python-Website herunterladen. Sie können jede Version von Python ab 3.10 verwenden (allerdings sollten Sie Alpha-, Beta- und Release-Candidate-Versionen vermeiden). Wir empfehlen dringend die Verwendung von Python 3.13 oder neuer.

Sie können Python auch über homebrew installieren, pyenv zur Verwaltung mehrerer Python-Installationen verwenden oder Anaconda oder Miniconda verwenden. Es spielt keine Rolle, wie Sie Python installiert haben – wichtig ist nur, dass Sie python3 von Ihrem Terminal aus ausführen können und einen funktionierenden, unterstützten Python-Interpreter erhalten.

Xcode und die Befehlszeilen-Entwicklerwerkzeuge stellen eine Version von Python zur Verfügung; diese ist jedoch Version 3.9. Python 3.9 hat das Ende seiner Lebensdauer erreicht und wird nicht mehr von Python oder BeeWare unterstützt. Sie werden nicht in der Lage sein, die von Xcode bereitgestellte Version von Python zu verwenden, um dieses Lernprogramm auszuführen.

Um die Version von Python zu überprüfen, die Sie installiert haben, führen Sie den folgenden Befehl aus:

$ python3 --version

Wenn Python installiert ist, wird die Versionsnummer angezeigt.

Unter Linux installieren Sie Python mit dem Paketmanager des Systems (apt unter Debian/Ubuntu/Mint, dnf unter Fedora, oder pacman unter Arch).

Sie sollten sich vergewissern, dass das System Python 3.8 oder eine neuere Version verwendet. Ist dies nicht der Fall (z. B. wird Ubuntu 18.04 mit Python 3.6 ausgeliefert), müssen Sie Ihre Linux-Distribution auf eine neuere Version aktualisieren.

Raspberry Pi wird derzeit nur begrenzt unterstützt.

Wichtig: Sie müssen das von Ihrem Betriebssystem bereitgestellte Python-System verwenden. Python-Installationen aus anderen Quellen (wie uv, pyenv, Anaconda, manuell kompiliertes Python usw.) verhindern, dass Sie Ihre Anwendung in späteren Schritten dieses Tutorials erfolgreich für die Verteilung verpacken können.

Wenn Sie unter Windows arbeiten, können Sie das offizielle Installationsprogramm von der Python-Website herunterladen. Sie können jede stabile Version von Python ab 3.8 verwenden. Wir raten dazu, Alphas, Betas und Release Candidates zu meiden, es sei denn, Sie wissen wirklich, was Sie tun.

Raspberry Pi wird derzeit nur begrenzt unterstützt.

Unter macOS oder Windows ist es egal, wie Sie Python installiert haben - wichtig ist nur, dass Sie python3 über die Eingabeaufforderung/Terminalanwendung Ihres Betriebssystems ausführen können und einen funktionierenden Python-Interpreter erhalten.

Abhängigkeiten installieren

Als Nächstes installieren Sie die zusätzlichen Abhängigkeiten, die für Ihr Betriebssystem erforderlich sind:

Die Erstellung von BeeWare-Anwendungen unter macOS erfordert:

  • Git, ein Versionskontrollsystem. Dies ist in Xcode oder den Befehlszeilen-Entwicklertools enthalten, die Sie oben installiert haben. Möglicherweise müssen Sie Xcode zum ersten Mal öffnen, damit Git in Ihrer Terminalsitzung funktioniert. Wenn immer noch nicht registriert wird, dass Git installiert ist, müssen Sie möglicherweise Ihre Terminalsitzung neu starten.

Um die lokale Entwicklung zu unterstützen, müssen Sie einige Systempakete installieren. Die Liste der erforderlichen Pakete hängt von Ihrer Distribution ab:

Ubuntu / Debian

$ sudo apt update
$ sudo apt install git build-essential pkg-config python3-dev python3-venv libgirepository1.0-dev libcairo2-dev gir1.2-gtk-3.0 libcanberra-gtk3-module

Red Hat / Fedora

$ sudo dnf install git gcc make pkg-config rpm-build python3-devel gobject-introspection-devel cairo-gobject-devel gtk3 libcanberra-gtk3

Arch / Manjaro

$ sudo pacman -Syu git base-devel pkgconf python3 gobject-introspection cairo gtk3 libcanberra

OpenSUSE Tumbleweed

$ sudo zypper install git patterns-devel-base-devel_basis pkgconf-pkg-config python3-devel gobject-introspection-devel cairo-devel gtk3 'typelib(Gtk)=3.0' libcanberra-gtk3-module

Andere Linux-Distributionen

Wenn Sie eine Linux-Distribution verwenden, die nicht in dieser Liste aufgeführt ist und nicht von einer in dieser Liste aufgeführten Distribution abgeleitet ist (z. B. sind Linux Mint und Pop! OS beide von Debian abgeleitete Distributionen; AlmaLinux ist von Fedora abgeleitet), werden Sie wahrscheinlich Schwierigkeiten haben, dieses Tutorial durchzuführen. Wenn Briefcase Sie warnt, dass „die Systempakete nicht überprüft werden können”, können Sie dieses Tutorial nicht durchführen.

Die Erstellung von BeeWare-Anwendungen unter Windows erfordert:

  • Git, ein Versionskontrollsystem. Sie können Git von [git-scm.com] herunterladen.

Nach der Installation dieser Tools sollten Sie sicherstellen, dass Sie alle Terminalsitzungen neu starten. Windows zeigt neu installierte Tools nur auf Terminals an, die nach Abschluss der Installation gestartet wurden.

Einrichten einer virtuellen Umgebung

Wir werden nun eine virtuelle Umgebung erstellen - eine "Sandbox", die wir verwenden können, um unsere Arbeit an diesem Tutorial von unserer Haupt-Python-Installation zu isolieren. Wenn wir Pakete in die virtuelle Umgebung installieren, wird unsere Haupt-Python-Installation (und alle anderen Python-Projekte auf unserem Computer) davon nicht betroffen sein. Wenn wir unsere virtuelle Umgebung komplett durcheinander bringen, können wir sie einfach löschen und neu beginnen, ohne dass andere Python-Projekte auf unserem Computer betroffen sind und ohne dass wir Python neu installieren müssen.

$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate

$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate

C:\...>md beeware-tutorial
C:\...>cd beeware-tutorial
C:\...>py -3.12 -m venv beeware-venv
C:\...>beeware-venv\Scripts\activate

Wenn Sie nicht Python 3.12 verwenden, ersetzen Sie das -3.12 in dieser Anleitung durch die Versionsnummer, die Sie verwenden.

Fehler bei der Ausführung von PowerShell-Skripten

Wenn Sie PowerShell verwenden und die folgende Fehlermeldung erhalten:

File C:\...\beeware-tutorial\beeware-venv\Scripts\activate.ps1 cannot be loaded because running scripts is disabled on this system.

Ihr Windows-Konto hat keine Berechtigung zum Ausführen von Skripts. So beheben Sie dies:

  1. Führen Sie Windows Powershell als Administrator aus.
  2. Führen Sie set-executionpolicy RemoteSigned aus
  3. Wählen Sie Y, um die Ausführungspolitik zu ändern.

Danach können Sie beeware-venv\Scripts\activate.ps1 in Ihrer ursprünglichen PowerShell-Sitzung (oder in einer neuen Sitzung im selben Verzeichnis) erneut ausführen.

Wenn dies geklappt hat, sollte Ihre Eingabeaufforderung nun geändert sein - sie sollte ein (beeware-venv)-Präfix haben. Dies zeigt Ihnen, dass Sie sich gerade in Ihrer virtuellen BeeWare-Umgebung befinden. Wann immer Sie an diesem Tutorial arbeiten, sollten Sie sicherstellen, dass Ihre virtuelle Umgebung aktiviert ist. Ist dies nicht der Fall, führen Sie den letzten Befehl (den Befehl activate) erneut aus, um Ihre Umgebung wieder zu aktivieren.

Alternative virtuelle Umgebungen

Wenn Sie Anaconda oder miniconda verwenden, sind Sie vielleicht mit der Verwendung von conda-Umgebungen besser vertraut. Vielleicht haben Sie auch schon von virtualenv gehört, einem Vorgänger von Pythons eingebautem venv Modul. Wie bei Python-Installationen ist es unter macOS oder Windows egal, wie Sie Ihre virtuelle Umgebung erstellen, solange Sie eine haben. Wenn Sie unter Linux arbeiten, sollten Sie sich an venv und das System-Python halten.

Nächste Schritte

Wir haben jetzt unsere Umgebung eingerichtet. Wir sind bereit, unsere erste BeeWare-Anwendung zu erstellen.