Dieses Repository ist veraltet.
Das Modern QDK-Repository finden Sie unter Microsoft/qsharp.
Beispiele, die das Azure Quantum Python-Paket verwenden, finden Sie im Azure Quantum Python-Repository.
Sie können das Modern QDK auch in VS Code for Web unter vscode.dev/quantum ausprobieren.
Weitere Informationen zum Modern QDK und Azure Quantum finden Sie unter https://aka.ms/AQ/Documentation.
Diese Beispiele demonstrieren die Verwendung des Quantum Development Kit für eine Vielzahl unterschiedlicher Quantencomputeraufgaben.
Jedes Beispiel ist in einem Ordner enthalten und zeigt, wie Q# zum Entwickeln von Quantenanwendungen verwendet wird.
Für eine kleine Anzahl der Beispiele gelten zusätzliche Installationsanforderungen, die über die für den Rest des Quantum Development Kit hinausgehen. Diese sind zusammen mit den vollständigen Installationsanweisungen in den README.md-Dateien für jedes Beispiel aufgeführt.
Anweisungen zur Installation des Quantum Development Kit finden Sie in unserer Online-Dokumentation, die auch eine Einführung in die Konzepte der Quantenprogrammierung enthält.
Eine Kurzanleitung zum Einrichten einer Entwicklungsumgebung von Grund auf mit Visual Studio Code oder GitHub Codespaces finden Sie hier.
Zu Ihrer Bequemlichkeit wird auch eine Docker-Image-Definition bereitgestellt. Anweisungen zum Erstellen und Verwenden finden Sie hier.
Wenn Sie mit Quantum oder dem Quantum Development Kit noch nicht vertraut sind, empfehlen wir Ihnen, mit den „Erste Schritte“-Beispielen zu beginnen.
Nachdem Sie Ihre Entwicklungsumgebung mit einer der oben genannten Optionen eingerichtet haben, versuchen Sie, über das Terminal zu samples/getting-started/teleportation
zu navigieren und dotnet run
auszuführen. Sie sollten etwa Folgendes sehen:
Round 1: Sent False, got False.
Teleportation successful!
Round 2: Sent True, got True.
Teleportation successful!
Round 3: Sent False, got False.
Teleportation successful!
Round 4: Sent False, got False.
Teleportation successful!
Round 5: Sent False, got False.
Teleportation successful!
Round 6: Sent False, got False.
Teleportation successful!
Round 7: Sent True, got True.
Teleportation successful!
Round 8: Sent False, got False.
Teleportation successful!
Herzlichen Glückwunsch, Sie können jetzt mit der Quantenprogrammierung beginnen!
Wenn Sie mit der Quantenentwicklung weiter voranschreiten, stellen wir Ihnen verschiedene Kategorien von Beispielen zur Verfügung, die Sie erkunden können:
Wir empfehlen Ihnen auch, einen Blick auf die Unit-Tests zu werfen, mit denen die Richtigkeit der Quantum Development Kit-Beispiele überprüft wird.
Dieses Repo enthält mehrere Konfigurationsdateien, die den Einstieg in die Codierung erleichtern. Nachfolgend finden Sie einige Anweisungen für den Einstieg in VSCode oder Jupyter-Notebooks.
Wenn Sie Code lieber lokal entwickeln möchten, empfehlen wir die Installation eines Editors wie Visual Studio Code. Stellen Sie sicher, dass Sie das .NET Core SDK 3.1 oder höher auf Ihrem lokalen Computer installieren. Ausführlichere Anweisungen zum Einrichten von VS-Code für die Entwicklung mit dem QDK finden Sie in unseren Dokumenten hier.
Nachdem Sie VS Code und das .NET Core SDK installiert haben, laden Sie dieses Repository auf Ihren Computer herunter und öffnen Sie den Ordner in VS Code. Der Editor erkennt die Dateien im .vscode
Ordner automatisch und fordert Sie auf, die empfohlene Erweiterung zu installieren. Dazu gehört die Erweiterung Microsoft Quantum Development Kit für Visual Studio Code, die den schnellsten Einstieg in das QDK ermöglicht.
Öffnen Sie ein Terminal, um mit der Ausführung Ihrer ersten Proben zu beginnen (siehe hier).
Eine weitere Möglichkeit, schnell mit der Entwicklung in Q# zu beginnen, besteht darin, Docker zu verwenden und ein Jupyter-Notebook auf Ihrem lokalen Computer zu starten. Mit der mitgelieferten Docker-Datei können Sie ein Docker-Image mit allen notwendigen Bibliotheken erstellen, um mit dem Quantum Development Kit Quantenanwendungen in C#, Python oder Jupyter zu erstellen.
Sobald Sie Docker installiert haben, können Sie mit den folgenden Befehlen loslegen:
So erstellen Sie das Docker-Image und taggen es mit iqsharp
:
docker build -t iqsharp .
Um das Image im Container namens iqsharp-container
mit interaktiver Befehlszeile auszuführen und den Container-Port 8888 auf den lokalen Port 8888 umzuleiten (erforderlich, um Jupyter auszuführen):
docker run -it --name iqsharp-container -p 8888:8888 iqsharp /bin/bash
Über die entsprechende Container-Befehlszeile können Sie die C#-Version des Teleportation-Beispiels ausführen, indem Sie Folgendes verwenden:
cd ~ /samples/getting-started/teleportation && dotnet run
Ebenso können Sie die Python-Version des Teleportationsbeispiels ausführen, indem Sie Folgendes verwenden:
cd ~ /samples/getting-started/teleportation && python host.py
Um schließlich Jupyter Notebook im Bild für das Teleportationsbeispiel zu starten, verwenden Sie Folgendes:
cd ~ /samples/getting-started/teleportation && jupyter notebook --ip=0.0.0.0 --no-browser
Sobald Jupyter gestartet ist, können Sie in Ihrem Browser das Teleportationsnotizbuch öffnen (Sie benötigen ein Token, das Jupyter beim Start im vorherigen Schritt generiert hat):
http://localhost:8888/notebooks/Notebook.ipynb
Sobald Sie fertig sind, entfernen Sie den Container mit dem Namen iqsharp-container
:
docker rm --force iqsharp-container