Guida introduttiva agli esempi di AWS SDK for C++ codice - AWS SDK for C++
Struttura degli esempi di codiceEsempi di codice di creazione e debug in Visual Studio

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Guida introduttiva agli esempi di AWS SDK for C++ codice

Struttura degli esempi di codice

La cartella di esempio C++ su Github contiene le cartelle di progetto per ogni servizio. AWS In genere, i singoli file sorgente.cpp nelle cartelle dimostrano una funzionalità o un'azione specifica per quel servizio. Ad esempio, per Amazon DynamoDB, recuperare un elemento dal database e caricarlo nel database sono due diversi tipi di azioni, quindi nella cartella DynamoDB c'è un file separato per ognuno di essi: and. get_item.cpp put_item.cpp Ogni file.cpp contiene una main() funzione come punto di accesso a un eseguibile autonomo. Gli eseguibili del progetto vengono generati in una cartella designata dal sistema di compilazione e a ogni file sorgente di esempio corrisponde un file eseguibile. Il nome del file eseguibile segue le convenzioni della piattaforma, ad esempio {name}.exe o just, {name} e CMakeLists.txt si applica qualsiasi prefisso personalizzato come. run_

Per eseguire una funzionalità di esempio

  1. Scarica l'esempio di codice desiderato dal AWS Code Examples Repository su GitHub.

  2. Apri un file.cpp per esplorarne la main() funzione e tutti i metodi chiamati.

  3. Crea il progetto, come dimostrato con l'esempio introduttivo in Guida introduttiva all'uso di. AWS SDK for C++ Nota che la creazione del progetto genera ogni eseguibile per ogni file sorgente del progetto.

  4. Esegui l'eseguibile per la funzionalità selezionata.

    • In un prompt dei comandi, esegui il programma utilizzando l'eseguibile in base al nome del *.cpp file.

    • Se lavori all'interno di un IDE, scegli il .cpp file della funzionalità che desideri dimostrare e selezionalo come opzione di avvio (o oggetto di avvio).

Test unitari

I test per esempi sono scritti utilizzando il GoogleTest framework. Per ulteriori informazioni, consulta GoogleTestPrimer sul GoogleTest sito Web.

I test unitari per ogni esempio si trovano in una tests sottocartella contenente il relativo CMakeLists.txt file. Per ogni file sorgente di esempio esiste un file di test corrispondente denominatogtest_<source file>. L'eseguibile di test per la sottocartella è denominato<Servizio AWS>_gtests.

CMakeFile Lists.txt

La cartella per ogni servizio contiene un file denominato CMakeLists.txt file. Molti di questi file contengono un costrutto simile al seguente:

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

Per ogni file.cpp nella cartella, il CMakeLists.txt file crea un eseguibile (cmake:add_executable) con un nome basato sul nome del file di codice sorgente senza l'estensione del file.

Esempi di codice di creazione e debug in Visual Studio

Creazione ed esecuzione dell'esempio di codice Amazon S3

  1. Ottieni il codice sorgente di esempio di Amazon S3. Questa procedura utilizza l'esempio di Esempi di codice Amazon S3 che utilizzano AWS SDK for C++ codice per iniziare a usare Visual Studio.

  2. In Windows Explorer, accedi alla s3 cartella (ad es.\aws-doc-sdk-examples\cpp\example_code\s3).

  3. Fai clic con il pulsante destro del mouse sulla cartella di s3 esempio e scegli Apri con Visual Studio.  Visual Studio for CMake projects non ha un file di «progetto», ma è l'intera cartella.

  4. Nel menu a discesa Configuration Selector nel menu principale di Visual Studio, assicurati che la configurazione selezionata corrisponda al tipo di build selezionato durante la creazione dell'SDK dal sorgente.  Ad esempio, è necessario selezionare una configurazione di debug se è stata creata dal sorgente utilizzando debug (-DCMAKE_BUILD_TYPE=Debugnella riga di CMake comando delle istruzioni di installazione dell'SDK).

  5. Apri il file. CMakeLists.txt

  6. Fai clic su Save (Salva). Ogni volta che fai clic su Salva sul CMakeLists.txt file, Visual Studio aggiorna i file CMake generati.  Se è visualizzata la scheda Output, è possibile visualizzare i messaggi di registro risultanti da questa generazione.

    • Nella scheda Output è presente una casella a discesa che dice: "Mostra l'output da:" e CMakedovrebbe essere l'opzione selezionata per impostazione predefinita.

    • L'ultimo messaggio in uscita dovrebbe dire «CMake generazione terminata». »  

    • Se l'ultimo messaggio non è questo, allora il CMake file presenta dei problemi. Non procedere con ulteriori passaggi finché il problema non viene risolto.  Consultare Risoluzione dei problemi di compilazione di AWS SDK for C++.

    • Nota che la CMake cache viene utilizzata da CMake per la velocità. Se state CMake risolvendo dei problemi, volete assicurarvi che i messaggi di errore che vi vengono forniti riflettano effettivamente le modifiche più recenti.  In Solution Explorer, fai clic con il pulsante destro del mouse su CMakeLists.txt e scegli CMakeCache, quindi scegli Elimina cache. Fatelo spesso quando risolvete progressivamente i CMake problemi.

  7. Per creare ed eseguire esempi da Visual Studio, Visual Studio colloca gli eseguibili in una struttura di cartelle diversa rispetto alla riga di comando. Per eseguire il codice, gli eseguibili SDK devono essere copiati nel posto giusto.  Trova la riga «TODO» del file CMake Lists (~riga 40) e scegli quella commentata per l'uso in Visual Studio. Visual Studio non utilizza una sottocartella dedicata al tipo di build, quindi questa non è inclusa.  Cambia la riga commentata nel CMakeLists.txt file per l'uso con Visual Studio.

  8. Elimina la CMake cache (come descritto sopra), fai clic nel CMakeLists.txt file per selezionare/attivare la scheda e scegli nuovamente Salva sul file per avviare la CMakeLists.txt generazione dei file di build. CMake

  9. Apri il file sorgente del «programma» che desideri eseguire.

    • Ad esempio, aprilist_buckets.cpp.

    • La cartella di esempio di Amazon S3 è codificata in modo che ogni «funzionalità» presentata di Amazon S3 sia dimostrata in un eseguibile dedicato proprio a tale funzionalità.  Ad esempio list_buckets.cpp diventerà un file eseguibile che mostra solo l'elenco dei bucket.

  10. Nel menu in alto, scegli Costruisci, quindi scegli Costruisci tutto.

    • La scheda Output from della scheda Output dovrebbe riflettere la selezione di Build e mostrare tutti i messaggi di creazione e collegamento.

    • L'ultimo output dovrebbe essere: "Build All è riuscito. »

    • Ora vengono generati file eseguibili per ciascuno dei singoli file sorgente.  Puoi confermarlo cercando nella directory di output della build (ad esempio\aws-doc-sdk-examples\cpp\example_code\s3\out\build\x64-Debug).

    • Nota che gli eseguibili hanno il prefisso «run_» perché il CMakeLists.txt file lo impone.

  11. Nel menu in alto, c'è una freccia verde e un selettore a discesa per Debug Target.  Scegli run_list_buckets.exe.

  12. Fai clic sul pulsante Esegui con la freccia verde per selezionare l'elemento di avvio.

  13. Si aprirà una finestra della console di debug di Visual Studio e verrà visualizzato l'output del codice.

  14. Premi un tasto per chiudere la finestra o chiudi manualmente la finestra per terminare il programma.  Puoi anche impostare i punti di interruzione nel codice e quando fai nuovamente clic su esegui, i punti di interruzione verranno raggiunti.