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 untuk C\$1\$1 kode
<a name="getting-started-code-examples"></a>

## Struktur contoh kode
<a name="structure"></a>

[Folder contoh C \$1\$1](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code) 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code) di. GitHub 

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

1. Bangun proyek, seperti yang ditunjukkan dengan contoh starter di [Memulai menggunakan AWS SDK untuk C\$1\$1](getting-started.md). Perhatikan bahwa membangun proyek menghasilkan setiap executable untuk setiap file sumber dalam proyek.

1. 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
<a name="unittest"></a>

Tes untuk contoh ditulis menggunakan GoogleTest kerangka kerja. Untuk mempelajari lebih lanjut, lihat [GoogleTestPrimer](https://google.github.io/googletest/primer.html) 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 bernama`gtest_<source file>`. Tes yang dapat dieksekusi untuk subfolder diberi nama. `<Layanan AWS>_gtests`

### CMakeLists.txt berkas
<a name="CMakeLists"></a>

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
<a name="buildingOnVisualStudio"></a>

**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 untuk C\$1\$1](examples-s3.md) kode untuk bangun dan berjalan menggunakan Visual Studio. 

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

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

1. 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=Debug`di baris CMake perintah dari instruksi instalasi SDK). 

1. Buka file`CMakeLists.txt`. 

1. 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 **CMake**harus 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\$1\$1 build](troubleshooting-cmake.md). 
   + 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. 

1. 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 (\$1 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. 

1. Hapus CMake cache (seperti dijelaskan di atas), klik `CMakeLists.txt` file select/activate ke tab, dan pilih **Simpan** pada `CMakeLists.txt` file lagi untuk memulai CMake pembuatan file build. 

1. Buka file sumber dari 'program' yang ingin Anda jalankan.
   + Misalnya, buka`list_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. 

1. 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\$1” karena file menentukan ini`CMakeLists.txt`. 

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

1. Klik **tombol lari panah hijau** untuk **Memilih Item Startup**. 

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

1. 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.