Bagikan melalui


Mulai cepat: Mengkloning repositori kode Python di Visual Studio

Dalam mulai cepat ini, Anda mengikuti langkah-langkah terpandu untuk mengkloning repositori GitHub kode Python dan membuat proyek. Visual Studio memudahkan untuk bekerja dengan proyek Python dengan menggunakan perintah Git untuk mengakses konten di bawah kontrol sumber. Anda juga dapat mengkloning repositori kode Python dari baris perintah lalu bekerja dengan proyek di Visual Studio.

Prasyarat

  • Visual Studio 2022 diinstal dengan dukungan untuk beban kerja Python. Visual Studio 2022 menyediakan integrasi yang mulus dengan GitHub dengan dukungan untuk perintah Git. Untuk informasi selengkapnya, lihat Menginstal dukungan Python di Visual Studio.
  • Visual Studio diinstal dengan dukungan untuk beban kerja Python, bersama dengan ekstensi GitHub untuk Visual Studio. Ekstensi ini memungkinkan Anda untuk bekerja dengan repositori GitHub dan perintah Git. Ekstensi GitHub tersedia di Alat Penginstal Visual Studio pada tab Komponen individual di bagian Alat kode:

    Cuplikan layar yang memperlihatkan cara memilih ekstensi GitHub di Penginstal Visual Studio.

Visual Studio untuk Mac tidak didukung. Untuk informasi selengkapnya, lihat Apa yang terjadi pada Visual Studio untuk Mac? Visual Studio Code di Windows, Mac, dan Linux berfungsi dengan baik dengan Python melalui ekstensi yang tersedia.

Mengkloning file repositori yang ada

Gunakan langkah-langkah berikut untuk mengkloning repositori yang ada dengan menggunakan perintah kontrol sumber Visual Studio Git :

  1. Di Visual Studio, pilih Klon Git>:

    Cuplikan layar yang memperlihatkan cara memilih opsi repositori Klon Git di Visual Studio 2022.

  2. Dalam dialog Kloning repositori, tentukan repositori GitHub untuk mengkloning:

    Cuplikan layar yang memperlihatkan cara menentukan repositori GitHub untuk dikloning di Visual Studio 2022.

    1. Untuk lokasi Repositori, masukkan URL repositori untuk mengkloning. Untuk latihan ini, masukkan https://github.com/gregmalcolm/python_koans.

    2. Untuk Jalur, masukkan folder di sistem tempat Anda ingin Visual Studio menyimpan file kloning.

      Folder yang Anda tentukan harus menjadi folder yang tepat yang Anda inginkan untuk digunakan Visual Studio. git clone Tidak seperti perintah, saat Anda membuat kloning di Team Explorer, Visual Studio tidak secara otomatis membuat subfolder baru dengan nama repositori.

    3. Saat Anda siap, pilih Kloning.

    Setelah kloning selesai, Visual Studio membuka panel Perubahan Git untuk repositori. Anda juga dapat melihat folder dengan file repositori kloning di Penjelajah Solusi.

  3. Pilih Repositori Lokal Git>dan konfirmasikan repositori kloning sekarang ada dalam daftar:

    Cuplikan layar yang memperlihatkan cara melihat daftar repositori GitHub lokal yang tersedia di Visual Studio 2022.

Gunakan langkah-langkah berikut untuk mengkloning repositori yang ada dengan menggunakan Visual Studio Team Explorer:

  1. Di Visual Studio, pilih Tampilkan>Team Explorer untuk membuka jendela Team Explorer . Pada halaman Koneksi, Anda dapat mengakses repositori GitHub atau Azure DevOps atau mengkloning repositori.

    Cuplikan layar halaman Koneksi Team Explorer memperlihatkan penyedia layanan yang dihosting, termasuk Azure DevOps dan GitHub, dan Repositori Git Lokal.

    Jika Team Explorer tidak terbuka di halaman Koneksi, pilih ikon plug pada toolbar Visual Studio untuk membuka halaman.

  2. Di halaman Team Explorer - Koneksi, perluas bagian Repositori Git Lokal, dan pilih opsi Kloning.

    1. Untuk lokasi Repositori, masukkan URL repositori untuk mengkloning. Untuk latihan ini, masukkan https://github.com/gregmalcolm/python_koans.

    2. Untuk Jalur, masukkan folder di sistem tempat Anda ingin Visual Studio menyimpan file kloning.

      Folder yang Anda tentukan harus menjadi folder yang tepat yang Anda inginkan untuk digunakan Visual Studio. git clone Tidak seperti perintah, saat Anda membuat kloning di Team Explorer, Visual Studio tidak secara otomatis membuat subfolder baru dengan nama repositori.

    3. Pilih opsi Submodul Kloning Rekursif.

    4. Di bagian bawah halaman, pilih Kloning.

Setelah kloning selesai, nama repositori muncul di daftar Repositori Git Lokal.

Penting

Dalam mulai cepat ini, Anda membuat klon langsung repositori python_koans di GitHub. Repositori semacam itu dilindungi oleh penulisnya dari perubahan langsung, jadi mencoba untuk melakukan perubahan pada repositori akan gagal. Dalam praktiknya, pengembang akan membuat fork repositori tersebut ke akun GitHub mereka sendiri, membuat perubahan di sana, lalu membuat permintaan pull untuk mengirimkan perubahan tersebut ke repositori asli. Jika Anda memiliki fork Anda sendiri, gunakan URL-nya, dan bukan URL repositori asli yang digunakan sebelumnya.

Membuat proyek dari file kloning

Setelah mengkloning repositori, Anda dapat membuat proyek baru dari file kloning.

Ikuti langkah-langkah ini untuk membuat proyek dari file yang sudah ada.

Penting

Proses berikut tidak memindahkan atau menyalin file sumber asli apa pun. Jika Anda ingin bekerja dengan salinan file Anda, pertama-tama duplikat folder lalu buat proyek.

  1. Buka Visual Studio dan pilih File>Proyek>Baru.

  2. Dalam dialog Buat proyek baru, cari python, dan pilih templat Dari kode Python yang Ada, dan pilih Berikutnya.

  3. Dalam dialog Konfigurasikan proyek baru Anda, masukkan Nama dan Lokasi proyek, pilih solusi untuk berisi proyek, dan pilih Buat.

  4. Di wizard Buat Proyek Baru dari Kode Python yang Sudah Ada, atur jalur Folder ke kode yang sudah ada, atur Filter untuk jenis file, dan tentukan jalur Pencarian apa pun yang diperlukan proyek Anda, lalu pilih Berikutnya. Jika Anda tidak mengetahui jalur pencarian, biarkan bidang kosong.

    Cuplikan layar pembuatan Proyek Baru dari Kode yang Ada, termasuk memilih jalur folder, filter jenis file, dan jalur pencarian.

  5. Pada halaman berikutnya, pilih file Startup untuk proyek Anda. Visual Studio memilih penerjemah dan versi Python global default. Anda dapat mengubah lingkungan dengan menggunakan menu dropdown. Jika Anda sudah siap, pilih Berikutnya.

    Catatan

    Dialog hanya memperlihatkan file dalam folder akar. Jika file yang Anda inginkan berada di subfolder, biarkan file startup kosong. Anda dapat mengatur file startup di Penjelajah Solusi, seperti yang dijelaskan di langkah selanjutnya.

    Cuplikan layar Pembuatan Proyek Baru dari jendela Kode yang Ada, termasuk memilih file startup dan lingkungan Python.

  6. Pilih lokasi untuk menyimpan file proyek ( file .pyproj pada disk). Jika berlaku, Anda juga dapat menyertakan deteksi otomatis lingkungan virtual dan menyesuaikan proyek untuk kerangka kerja web yang berbeda. Jika Anda tidak yakin dengan opsi ini, biarkan bidang diatur ke default.

    Cuplikan layar pembuatan Proyek Baru dari jendela Kode yang Ada, termasuk lokasi untuk file proyek dan pengaturan opsional lainnya.

  7. Pilih Selesai.

    Visual Studio membuat proyek dan membukanya di Penjelajah Solusi. Jika Anda ingin memindahkan file .pyproj ke lokasi lain, pilih file di Penjelajah Solusi, lalu pilih Simpan File>Sebagai pada toolbar. Tindakan ini memperbarui referensi file dalam proyek, tetapi tidak memindahkan file kode apa pun.

  8. Untuk mengatur file startup yang berbeda, temukan file di Penjelajah Solusi, klik kanan file, dan pilih Atur sebagai File Startup.

  1. Di daftar Repositori Git Lokal, klik dua kali nama repositori. Dasbor repositori terbuka di halaman Team Explorer - Beranda dengan opsi GitHub, Project, dan Solutions .

  2. Perluas bagian Solusi dan pilih Baru untuk membuat proyek baru.

    Cuplikan layar halaman Beranda Team Explorer memperlihatkan cara membuat proyek baru dari repositori kloning.

  3. Dalam dialog Buat proyek baru, atur Filter bahasa ke Python (atau cari python), pilih templat Dari Kode Python yang Ada, dan pilih Berikutnya.

  4. Dalam dialog Konfigurasikan proyek baru Anda, masukkan Nama proyek, atur Lokasi ke folder yang sama dengan repositori, dan pilih OK. Wizard Buat Proyek Baru dari Kode Python yang Ada terbuka.

  5. Di wizard, pilih Selesai.

Mengonfigurasi properti proyek

Untuk menjalankan proyek, Anda perlu mengidentifikasi direktori kerja untuk proyek, dan memberi tahu Visual Studio file mana yang akan digunakan sebagai File Startup.

Ikuti langkah-langkah berikut untuk mengonfigurasi properti proyek Anda:

  1. Di Penjelajah Solusi, perluas simpul proyek, klik kanan file contemplate_koans.py, dan pilih Atur sebagai File Startup. Tindakan ini memungkinkan Visual Studio mengetahui file mana yang akan digunakan untuk menjalankan proyek.

  2. Pada toolbar Visual Studio utama, pilih Properti Proyek>untuk membuka properti untuk proyek.

  3. Pada tab Umum , amati nilai Direktori Kerja untuk proyek.

    Secara default, Visual Studio mengatur Direktori Kerja ke akar proyek (.). Perhatikan bahwa File Startup tidak memiliki lokasi folder tertentu.

    Cuplikan layar yang memperlihatkan direktori kerja saat ini untuk proyek Python yang diatur ke akar proyek.

    Kode program kloning mencari file bernama koans.txt di direktori kerja. Kode mengharapkan direktori menjadi lokasi folder tempat Anda menginstruksikan Visual Studio untuk menyimpan file repositori kloning. Jika Anda membiarkan Direktori Kerja diatur ke akar proyek (.), program menghasilkan kesalahan runtime.

  4. Atur nilai Direktori Kerja ke lokasi folder repositori kloning, seperti C:\Users\contoso\source\repos\Python-Koans.

    Tip

    Cara cepat untuk mengonfirmasi lokasi folder untuk file kloning adalah dengan memeriksa properti untuk file kloning di Penjelajah Solusi. Klik kanan file koans.txt dan pilih Properti untuk membuka panel detail di bawah Penjelajah Solusi. Di panel detail, perhatikan bahwa lokasi folder untuk file tercantum di properti Jalur lengkap. Anda dapat menempelkan nilai ini ke bidang Direktori Kerja di halaman Properti proyek.

    Cuplikan layar yang memperlihatkan cara mengatur Direktori Kerja untuk proyek dengan nilai properti Jalur Lengkap untuk file kloning.

    Cuplikan layar yang memperlihatkan cara mengatur direktori kerja untuk proyek Python.

  5. Simpan perubahan Anda dan tutup panel Properti proyek.

Menjalankan program Python

Sekarang Anda siap untuk mencoba menjalankan aplikasi untuk proyek baru:

  1. Pilih Debug>Mulai tanpa Penelusuran Kesalahan (atau gunakan pintasan keyboard Ctrl+F5) untuk menjalankan program.

    Jika Anda melihat kesalahan runtime FileNotFoundError untuk file koans.txt, konfirmasikan Direktori Kerja diatur dengan benar, seperti yang dijelaskan di bagian sebelumnya.

  2. Ketika program berhasil berjalan, program menampilkan kesalahan pernyataan pada baris 17 dari file proyek /koans/about_asserts.py:

    Cuplikan layar yang menunjukkan output awal dari program koans Python yang menghasilkan kesalahan pernyataan dalam file about_asserts.

    Kesalahan pernyataan disengaja. Program ini dirancang untuk mengajarkan Python dengan meminta Anda memperbaiki semua kesalahan yang disengaja. Anda dapat menemukan informasi lebih lanjut tentang program ini di Ruby Koans, yang menginspirasi Python Koans.

  3. Keluar dari program.

  4. Di Penjelajah Solusi, klik dua kali file /koans/about_asserts.py untuk membuka file di editor:

    Cuplikan layar yang memperlihatkan cara membuka file about_asserts di Visual Studio.

    Secara default, nomor baris tidak muncul di editor. Untuk melihat nomor baris, pilih Opsi Alat>, perluas bagian Umum Python>Editor>Teks, dan pilih opsi Nomor baris:

    Cuplikan layar yang memperlihatkan cara mengaktifkan penomoran baris di editor dengan opsi Nomor Baris Umum Python Editor Teks.

    Secara default, nomor baris tidak muncul di editor. Untuk melihat nomor baris, pilih Opsi Alat>, dan pilih Perlihatkan semua pengaturan di bagian bawah dialog. Perluas bagian Umum Python>Editor>Teks dan pilih opsi Nomor baris:

    Cuplikan layar yang memperlihatkan cara mengaktifkan nomor baris untuk file kode Python.

  5. Koreksi kesalahan dalam file /koans/about_asserts.py dengan mengubah False argumen pada baris 17 menjadi True. Berikut tampilan kode yang diperbarui:

    self.assertTrue(True) # This value should be True
    
  6. Jalankan kembali programnya.

    Jika Visual Studio memperingatkan tentang kesalahan, tanggapi dengan Ya untuk terus menjalankan kode. Kali ini, program melewati pemeriksaan pertama dan berhenti pada koan berikutnya. Anda dapat terus memperbaiki kesalahan lebih lanjut dan menjalankan program untuk melihat penyesuaian.