Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erste Schritte mit den AWS SDK für C\$1\$1 Codebeispielen
<a name="getting-started-code-examples"></a>

## Struktur der Codebeispiele
<a name="structure"></a>

Der [C\$1\$1-Beispielordner](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code) auf Github enthält Projektordner für jeden AWS Dienst. In der Regel demonstrieren einzelne .cpp-Quelldateien in den Ordnern eine bestimmte Funktionalität oder Aktion für diesen Dienst. Für Amazon DynamoDB sind das *Abrufen* eines Elements aus der Datenbank und das *Hochladen* eines Elements in die Datenbank beispielsweise zwei verschiedene Aktionstypen, sodass es für jede Aktion eine separate Datei im DynamoDB-Ordner gibt: und. `get_item.cpp` `put_item.cpp` Jede CPP-Datei enthält eine `main()` Funktion als Einstiegspunkt zu einer eigenständigen ausführbaren Datei. Die ausführbaren Projektdateien werden in einem Ordner generiert, der von Ihrem Build-System festgelegt wurde, und jeder Beispielquelldatei entspricht eine ausführbare Datei. Der Dateiname der ausführbaren Datei folgt den Konventionen der Plattform wie `{name}.exe` oder einfach, `{name}` und es `CMakeLists.txt` gilt jedes benutzerdefinierte Präfix wie. `run_` 

**Um eine Beispielfunktion auszuführen**

1. Laden Sie das gewünschte Codebeispiel aus dem [AWS Codebeispiel-Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code) unter herunter GitHub. 

1. Öffnen Sie eine.cpp-Datei, um ihre `main()` Funktion und alle aufgerufenen Methoden zu untersuchen. 

1. Erstellen Sie das Projekt, wie anhand des Starterbeispiels [unter Erste Schritte mit dem AWS SDK für C\$1\$1](getting-started.md) gezeigt wird. Beachten Sie, dass beim Erstellen des Projekts jede ausführbare Datei für jede Quelldatei im Projekt generiert wird.

1. Führen Sie die ausführbare Datei für die ausgewählte Funktionalität aus.
   + Führen Sie das Programm in einer Befehlszeile mit der ausführbaren Datei aus, die auf dem Namen der `*.cpp` Datei basiert.
   + Wenn Sie in einer IDE arbeiten, wählen Sie die `.cpp` Datei mit der Funktionalität aus, die Sie demonstrieren möchten, und wählen Sie sie als Startoption (oder Startobjekt) aus.

### Komponententests
<a name="unittest"></a>

Tests für Beispiele werden mit dem GoogleTest Framework geschrieben. Weitere Informationen finden Sie unter [GoogleTestPrimer](https://google.github.io/googletest/primer.html) auf der GoogleTest Website.

Die Komponententests für jedes Beispiel befinden sich in einem `tests` Unterordner, der eine eigene `CMakeLists.txt` Datei enthält. Für jede Beispielquelldatei gibt es eine entsprechende Testdatei mit dem Namen`gtest_<source file>`. Die ausführbare Testdatei für den Unterordner ist benannt`<AWS-Service>_gtests`.

### CMakeDatei Lists.txt
<a name="CMakeLists"></a>

Der Ordner für jeden Dienst enthält eine Datei mit dem Namen `CMakeLists.txt` file. Viele dieser Dateien enthalten ein Konstrukt, das dem folgenden ähnelt:

```
foreach(EXAMPLE IN LISTS EXAMPLES)
         add_executable(${EXAMPLE} ${EXAMPLE}.cpp)
         target_link_libraries(${EXAMPLE} aws-cpp-sdk-email aws-cpp-sdk-core)
endforeach()
```

 Für jede .cpp-Datei im Ordner erstellt die `CMakeLists.txt` Datei eine ausführbare Datei (cmake:`add_executable`) mit einem Namen, der auf dem Namen der Quellcodedatei ohne die Dateierweiterung basiert. 

## Codebeispiele in Visual Studio erstellen und debuggen
<a name="buildingOnVisualStudio"></a>

**Erstellen und Ausführen des Amazon S3 S3-Codebeispiels**

1. Besorgen Sie sich den Amazon S3 S3-Beispielquellcode. Dieses Verfahren verwendet das [Amazon S3 S3-Codebeispiele mit dem AWS SDK für C\$1\$1](examples-s3.md) Codebeispiel, um Visual Studio zum Laufen zu bringen. 

1. Navigieren Sie im Windows Explorer zu dem `s3` Ordner (z. B.`\aws-doc-sdk-examples\cpp\example_code\s3`). 

1. Klicken Sie mit der rechten Maustaste auf den `s3` Beispielordner und wählen Sie **Mit Visual Studio öffnen**.  Visual Studio für CMake Projekte hat keine Projektdatei, sondern den gesamten Ordner. 

1. Stellen Sie in der Dropdownliste zur **Konfigurationsauswahl** im oberen Menü von Visual Studio sicher, dass die ausgewählte Konfiguration dem Buildtyp entspricht, den Sie beim Erstellen des SDK aus dem Quellcode ausgewählt haben.  Beispielsweise sollte eine **Debug-Konfiguration** ausgewählt werden, wenn Sie mithilfe von Debug (`-DCMAKE_BUILD_TYPE=Debug`in der CMake Befehlszeile der SDK-Installationsanweisungen) aus dem Quellcode erstellt haben. 

1. Datei öffnen. `CMakeLists.txt` 

1. Klicken Sie auf **Speichern**. Jedes Mal, wenn Sie in der `CMakeLists.txt` Datei auf **Speichern** klicken, aktualisiert Visual Studio die CMake generierten Dateien.  Wenn Sie die Registerkarte **Ausgabe** angezeigt haben, können Sie die resultierenden Protokollmeldungen dieser Generation sehen. 
   + Auf der Registerkarte **Ausgabe** befindet sich ein Dropdown-Feld mit der **Aufschrift „Ausgabe anzeigen von:**“. Diese Option **CMake**sollte standardmäßig ausgewählt sein. 
   + Bei der letzten Nachrichtenausgabe sollte „**CMake Generierung abgeschlossen“ stehen.** “  
   + Wenn die letzte Nachricht nicht das ist, dann hat die CMake Datei Probleme. Fahren Sie nicht mit weiteren Schritten fort, bis das Problem behoben ist.  Siehe [Behebung von Problemen mit AWS SDK for C\$1\$1 C\$1\$1-Build](troubleshooting-cmake.md). 
   + Beachten Sie, dass der CMake Cache aus CMake Geschwindigkeitsgründen verwendet wird. Wenn Sie CMake Probleme lösen, sollten Sie dafür sorgen, dass alles in Ordnung ist, sodass die Fehlermeldungen, die Sie erhalten, tatsächlich Ihre letzten Änderungen widerspiegeln.  **Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf `CMakeLists.txt` und wählen Sie **CMakeCache**. Wählen Sie dann Cache löschen.** Tun Sie dies häufig, wenn Sie CMake Probleme schrittweise lösen. 

1. Um Beispiele in Visual Studio zu erstellen und auszuführen, platziert Visual Studio die ausführbaren Dateien in einer anderen Ordnerstruktur als in der Befehlszeile. Um den Code auszuführen, müssen die ausführbaren SDK-Dateien an die richtige Stelle kopiert werden.  Suchen Sie die Zeile „`TODO`“ der CMake Lists-Datei (\$1Zeile 40) und wählen Sie die Zeile aus, die für die Verwendung in Visual Studio kommentiert wurde. Visual Studio verwendet keinen Unterordner, der dem Buildtyp zugewiesen ist, sodass dieser nicht enthalten ist.  Tauschen Sie die auskommentierte Zeile in der `CMakeLists.txt` Datei für die Verwendung in Visual Studio aus. 

1. Löschen Sie den CMake Cache (wie oben beschrieben), klicken Sie in der `CMakeLists.txt` Datei auf select/activate die Registerkarte und wählen Sie erneut **Speichern** für die `CMakeLists.txt` Datei, um die Generierung der CMake Build-Dateien zu starten. 

1. Öffnen Sie die Quelldatei des „Programms“, das Sie ausführen möchten.
   + Öffnen Sie zum Beispiel`list_buckets.cpp`.
   + Der Amazon S3-Beispielordner ist so codiert, dass jede vorgestellte „Funktion“ von Amazon S3 in einer speziellen ausführbaren Datei für genau diese Funktion demonstriert wird.  `list_buckets.cpp`Wird z. B. zu einer ausführbaren Datei, die nur die Auflistung von Buckets demonstriert. 

1. Wählen Sie im oberen Menü **Build** und dann **Build All**. 
   + Die Option „**Ausgabe** **anzeigen von“ auf der Registerkarte „Ausgabe**“ sollte die Auswahl von „**Build**“ widerspiegeln und alle Nachrichten zum Erstellen und Verknüpfen anzeigen. 
   + Die letzte Ausgabe sollte lauten: „**Build All successfully“.** “ 
   + Jetzt werden ausführbare Dateien für jede der einzelnen Quelldateien generiert.  Sie können dies überprüfen, indem Sie im Build-Ausgabeverzeichnis nachschauen (z. B.`\aws-doc-sdk-examples\cpp\example_code\s3\out\build\x64-Debug`).
   + Beachten Sie, dass den ausführbaren Dateien das Präfix „run\$1“ vorangestellt wird, da die `CMakeLists.txt` Datei dies vorschreibt. 

1. **Im oberen Menü befinden sich ein **grüner Pfeil** und eine **Dropdownauswahl** für Debug Target.**  Wählen Sie `run_list_buckets.exe`. 

1. Klicken Sie auf die **Startschaltfläche mit dem grünen Pfeil**, um das **Startelement auszuwählen**. 

1. Ein Fenster der Visual Studio Debug Console wird geöffnet und die Ausgabe des Codes wird angezeigt. 

1. Drücken Sie eine Taste, um das Fenster zu schließen, oder schließen Sie das Fenster manuell, um das Programm zu beenden.  Sie können im Code auch Haltepunkte setzen. Wenn Sie erneut auf Ausführen klicken, werden die Haltepunkte erreicht.