Memulai dengan contoh AWS SDK for C++ kode - AWS SDK for C++
Struktur contoh kodeContoh Kode Bangunan dan Debugging di Visual Studio

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memulai dengan contoh AWS SDK for C++ kode

Struktur contoh kode

Folder contoh C ++ di Github berisi folder proyek untuk setiap layanan. AWS Biasanya, file sumber.cpp individual dalam folder menunjukkan fungsionalitas atau tindakan tertentu untuk layanan itu. Misalnya, untuk Amazon DynamoDB, mendapatkan item dari database dan mengunggah item ke database adalah dua jenis tindakan yang berbeda, jadi ada file terpisah untuk masing-masing di folder DynamoDB: dan. get_item.cpp put_item.cpp Setiap file.cpp berisi main() fungsi sebagai titik masuk ke executable mandiri. Eksekutabel proyek dibuat dalam folder yang ditentukan oleh sistem build Anda, dan ada satu file yang dapat dieksekusi yang sesuai dengan setiap file sumber contoh. Nama file yang dapat dieksekusi mengikuti konvensi platform seperti {name}.exe atau hanya {name} dan awalan CMakeLists.txt khusus apa pun berlaku seperti. run_

Untuk menjalankan fungsionalitas contoh

  1. Unduh contoh kode yang diinginkan dari Repositori Contoh AWS Kode di. GitHub

  2. Buka file.cpp untuk menjelajahi main() fungsinya dan metode apa pun yang disebut.

  3. Bangun proyek, seperti yang ditunjukkan dengan contoh starter di Memulai menggunakan AWS SDK for C++. Perhatikan bahwa membangun proyek menghasilkan setiap executable untuk setiap file sumber dalam proyek.

  4. Jalankan executable untuk fungsionalitas yang dipilih.

    • Dalam command prompt, jalankan program itu menggunakan executable berdasarkan nama file. *.cpp

    • Jika Anda bekerja dalam IDE, pilih .cpp file fungsionalitas yang ingin Anda tunjukkan dan pilih sebagai opsi startup (atau objek startup).

Tes unit

Tes untuk contoh ditulis menggunakan GoogleTest kerangka kerja. Untuk mempelajari lebih lanjut, lihat GoogleTestPrimer di GoogleTest situs web.

Tes unit untuk setiap contoh berada dalam tests subfolder yang berisi CMakeLists.txt file-nya sendiri. Untuk setiap file sumber contoh ada file uji yang sesuai bernamagtest_<source file>. Tes yang dapat dieksekusi untuk subfolder diberi nama. <Layanan AWS>_gtests

CMakeLists.txt berkas

Folder untuk setiap layanan berisi file bernama CMakeLists.txt file. Banyak dari file-file ini berisi konstruksi yang mirip dengan berikut ini:

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

Untuk setiap file.cpp di folder, CMakeLists.txt file membangun executable (cmake:add_executable) dengan nama berdasarkan nama file kode sumber tanpa ekstensi file.

Contoh Kode Bangunan dan Debugging di Visual Studio

Membangun dan menjalankan contoh kode Amazon S3

  1. Dapatkan contoh kode sumber Amazon S3. Prosedur ini menggunakan contoh Contoh kode Amazon S3 menggunakan AWS SDK for C++ kode untuk bangun dan berjalan menggunakan Visual Studio.

  2. Di Windows Explorer, arahkan ke s3 folder (mis.\aws-doc-sdk-examples\cpp\example_code\s3).

  3. Klik kanan pada folder s3 contoh dan pilih Buka dengan Visual Studio.  Visual Studio untuk CMake proyek tidak memiliki file 'proyek', melainkan seluruh folder.

  4. Di menu tarik-turun Pemilih Konfigurasi di menu atas Visual Studio, pastikan konfigurasi yang dipilih cocok dengan jenis build yang Anda pilih saat membuat SDK dari sumber.  Misalnya konfigurasi Debug harus dipilih jika Anda membangun dari sumber menggunakan debug (-DCMAKE_BUILD_TYPE=Debugdi baris CMake perintah dari instruksi instalasi SDK).

  5. Buka fileCMakeLists.txt.

  6. Klik Simpan. Setiap kali Anda mengklik Simpan pada CMakeLists.txt file, Visual Studio menyegarkan file CMake yang dihasilkan.  Jika tab Output ditampilkan, Anda dapat melihat pesan log yang dihasilkan dari generasi ini.

    • Ada kotak drop-down di dalam tab Output yang mengatakan: "Tampilkan output dari:" dan CMakeharus menjadi opsi yang dipilih secara default.

    • Output pesan terakhir harus mengatakan "CMake generasi selesai. “  

    • Jika pesan terakhir bukan ini, maka CMake file tersebut memiliki masalah. Jangan melanjutkan ke langkah lebih lanjut sampai ini diselesaikan.  Lihat Memecahkan masalah AWS SDK for C++ build.

    • Perhatikan bahwa CMake cache digunakan oleh CMake untuk kecepatan. Jika Anda mengatasi CMake masalah, Anda ingin memastikan 'bilah bersih' sehingga pesan kesalahan yang Anda berikan sebenarnya mencerminkan perubahan terbaru Anda.  Di Solution Explorer, klik kanan CMakeLists.txt dan pilih CMakeCache, lalu pilih Delete Cache. Lakukan ini sering ketika bekerja secara progresif melalui CMake masalah.

  7. Untuk membangun dan menjalankan contoh dari dalam Visual Studio, Visual Studio menempatkan executable dalam struktur folder yang berbeda dari baris perintah. Untuk menjalankan kode, executable SDK harus disalin ke tempat yang tepat.  Temukan baris “TODO” dari file CMake Daftar (~ baris 40) dan pilih yang dikomentari untuk digunakan di Visual Studio. Visual Studio tidak menggunakan subfolder yang didedikasikan untuk tipe build sehingga ini tidak disertakan.  Ganti baris yang dikomentari dalam CMakeLists.txt file untuk penggunaan Visual Studio.

  8. Hapus CMake cache (seperti dijelaskan di atas), klik CMakeLists.txt file untuk memilih/mengaktifkan tab, dan pilih Simpan pada CMakeLists.txt file lagi untuk memulai pembuatan file CMake build.

  9. Buka file sumber dari 'program' yang ingin Anda jalankan.

    • Misalnya, bukalist_buckets.cpp.

    • Folder contoh Amazon S3 dikodekan sehingga setiap 'fitur' Amazon S3 yang dipamerkan ditunjukkan dalam executable khusus hanya untuk fitur itu.  Misalnya list_buckets.cpp akan menjadi executable yang hanya menunjukkan daftar bucket.

  10. Di menu atas, pilih Build, lalu pilih Build All.

    • Tab Output Tampilkan output dari harus mencerminkan pemilihan Build, dan menampilkan semua pesan bangunan dan penautan.

    • Output terakhir harus: "Build All berhasil. “

    • Sekarang executable untuk masing-masing file sumber individu dihasilkan.  Anda dapat mengonfirmasi ini dengan melihat di direktori keluaran build (mis.\aws-doc-sdk-examples\cpp\example_code\s3\out\build\x64-Debug).

    • Perhatikan bahwa executable diawali dengan “run_” karena file menentukan iniCMakeLists.txt.

  11. Di menu atas, ada panah hijau dan pemilih drop-down untuk Debug Target.  Pilih run_list_buckets.exe.

  12. Klik tombol lari panah hijau untuk Memilih Item Startup.

  13. Sebuah jendela Visual Studio Debug Console akan terbuka dan menampilkan output dari kode.

  14. Tekan tombol untuk menutup jendela, atau menutup jendela secara manual, untuk mengakhiri program.  Anda juga dapat mengatur breakpoint dalam kode dan ketika Anda mengklik run lagi breakpoint akan terkena.