Bagikan melalui


Membuat permintaan pull di Visual Studio

Jika Anda diautentikasi ke GitHub atau Azure DevOps dan telah mendorong perubahan ke repositori jarak jauh, Anda dapat membuat permintaan pull tanpa meninggalkan Visual Studio. Permintaan pull adalah alat penting di GitHub dan Azure DevOps untuk peninjauan kode. Ulasan ini membantu menangkap masalah dalam fitur baru dan memungkinkan rekan satu tim untuk berbagi pengalaman mereka dengan berbagai wilayah basis kode - meningkatkan kesehatan basis kode secara keseluruhan.

Untuk membuat permintaan pull, ikuti langkah-langkah berikut:

  1. Sebelum dapat membuat permintaan pull, Anda perlu membuat cabang baru untuk perubahan Anda. Cabang ini memisahkan modifikasi Anda dari cabang utama hingga siap untuk digabungkan.

  2. Kemudian, Anda dapat melakukan commit dan mem-push perubahan seperti biasa di jendela Perubahan Git.

  3. Pilih tautan di banner pemberitahuan untuk Buat di Visual Studio atau Buat di Browser.

    Cuplikan layar jendela Perubahan Git dengan infobar 'Berhasil mendorong QP ke asal. Permintaan pull: Buat di Visual Studio atau buat di browser.' di Visual Studio 2022.

    Atau, Anda dapat membuat permintaan pull dari cabang jarak jauh dengan menavigasi ke jendela Permintaan Pull Baru melalui menu tingkat atas Git>GitHub atau Azure DevOps>New Pull Request. Atau klik kanan cabang di Jendela Repositori Git.

    menu tingkat atas Git dengan pilihan GitHub dan teks 'Permintaan Tarik Baru' disorot di Visual Studio 2022.

    Atau klik kanan cabang di Jendela Repositori Git untuk membuka menu konteks dan pilih Permintaan Penarikan Baru.

    Jendela Repositori Git dengan teks tautan masuk/keluar disorot di Visual Studio 2022.

    Ketika Anda mencoba membuat permintaan pull tetapi Anda memiliki beberapa akun di rantai kunci Anda, Anda akan melihat permintaan yang meminta akun mana yang akan digunakan. Lihat Menambahkan akun GitHub ke rantai kunci Anda.

  4. Pilih cabang yang ingin Anda gabungkan dan beri permintaan pull Anda judul dan deskripsi deskriptif. Anda dapat menggunakan sintaks markdown untuk memformat deskripsi permintaan pull Anda dari Visual Studio. Cobalah dengan mengetik simbol markdown di kotak Deskripsi dan pratinjau markdown Anda dengan memilih tombol Pratinjau.

    Saran

    Dengan Visual Studio 2022 versi 17.10 dan yang lebih baru dan ekstensi GitHub Copilot, Anda dapat menggunakan AI untuk menghasilkan deskripsi permintaan pull terperinci yang menjelaskan perubahan Anda. Tekan ikon pena berkilau untuk meminta Agar GitHub Copilot menghasilkan deskripsi PR. Untuk menginstal GitHub Copilot, lihat Menginstal dan mengelola GitHub Copilot di Visual Studio.

    Cuplikan layar ikon pena berkilau untuk meminta Agar GitHub Copilot menghasilkan deskripsi PR.

    Jendela Pull Request Baru dengan teks tombol pratinjau yang disorot di Visual Studio 2022.

  5. Tampilan perbedaan memungkinkan Anda melihat semua perubahan dalam file yang telah diterapkan sebagai bagian dari pull request Anda. Lihat Membandingkan file - tampilan berbeda.

    Saran

    Opsi tampilan perbedaan ringkasan memungkinkan Anda hanya meninjau bagian kode yang diubah.

    Jendela Permintaan Pull Baru dengan teks tombol ringkasan disorot di Visual Studio 2022.

  6. Anda dapat menautkan item kerja dengan merujuknya melalui pencarian masalah , dengan mengetik # di kotak deskripsi atau menekan tombol # di sudut kanan bawah. Anda juga dapat menambahkan peninjau dengan mengetikkan nama pengguna GitHub atau identitas atau email Azure DevOps mereka.

    Permintaan Pull Baru dengan # di kotak deskripsi dan daftar masalah GitHub terkait dan permintaan pull yang ditampilkan di Visual Studio 2022.

  7. Setelah Anda mengklik Buat pada permintaan pull Anda, pengembang lain dapat meninjau perubahan Anda dan memberikan umpan balik. Atau, dengan Visual Studio 17.12 dan yang lebih baru, klik menu dropdown dan pilih Buat sebagai draf.

    Cuplikan layar memperlihatkan opsi untuk membuat permintaan pull baru sebagai draf.

Pelajari selengkapnya tentang cara menambahkan templat permintaan pull ke repositori Anda di dokumentasi GitHub dan dokumentasi Azure DevOps.

Melihat atau menambahkan komentar permintaan penarikan di editor

Dengan Visual Studio 17.11 atau yang lebih baru, Anda dapat melihat komentar dan saran dari peninjau tanpa mengalihkan konteks ke browser.

Cuplikan layar memperlihatkan komentar PR.

Untuk mengaktifkan fitur ini, buka panelOpsi>, perluas bagianSemua Fitur Pratinjau>, dan pilih kotak centang Komentar Permintaan Penarikan.

Untuk mengaktifkan fitur ini, buka dialogOpsi>, dan perluas bagianFitur Pratinjau>. Pilih kotak centang Tarik Komentar Permintaan , lalu pilih OK.

Lihat komentar permintaan tarik

Untuk melihat komentar untuk permintaan tarik, lihat cabang mana pun yang memiliki permintaan tarik aktif dan pilih Tampilkan komentar dalam file dari infobar ini. Anda juga dapat memilih nomor PR di jendela Perubahan Git atau dari menu tingkat atas Git dengan Git>GitHub atau Azure DevOps>untuk menampilkan komentar dalam file.

Cuplikan layar memperlihatkan tautan untuk menampilkan komentar di jendela Perubahan Git.

Menambahkan komentar pada pull request

Dengan Visual Studio 17.13 atau yang lebih baru, Anda dapat meninjau permintaan pull, atau menambahkan komentar. Untuk mengaktifkan fitur ini, buka panelOpsi>, perluas bagianSemua Fitur Pratinjau>, dan pilih kotak centang Komentar Permintaan Penarikan.

Dengan Visual Studio 17.13 atau yang lebih baru, Anda dapat meninjau permintaan pull, atau menambahkan komentar. Untuk mengaktifkan fitur ini, buka dialogOpsi>, dan perluas bagianFitur Pratinjau>. Pilih kotak centang Tarik Komentar Permintaan , lalu pilih OK.

Setelah Anda mengaktifkan komentar, lihat cabang mana pun dengan permintaan pull aktif dan klik Tampilkan komentar dalam file di bilah info. Navigasikan melalui perubahan dengan menggunakan tombol toolbar di atas file kode.

Untuk menambahkan komentar, klik ikon Tambahkan komentar ke sisi kiri editor, seperti yang ditunjukkan pada cuplikan layar berikut.

Cuplikan layar memperlihatkan ikon Tambahkan komentar saat meninjau perubahan file dalam permintaan pull.

Anda juga dapat mengklik kanan pada baris kode dan, pada menu konteks, pilih Git>Tambahkan komentar.

Teks komentar tidak diterbitkan sampai Anda mengklik tombol Tambahkan Komentar di jendela komentar.

Anda bisa melanjutkan percakapan pada komentar yang sudah ada dengan menggunakan bagian Balasan di kotak komentar. Komentar aktif atau teratasi. Anda dapat mengklik Balas dan Selesaikan untuk membalas komentar dan mengubah status untuk diselesaikan dalam satu klik, atau mengubah status menggunakan menu dropdown di atas teks komentar.

Anda dapat mengalihkan status suka Anda pada komentar dengan mengklik ikon, atau dengan mengklik tiga titik, Anda dapat menyalin teks komentar ke clipboard, menyalin tautan ke komentar ke clipboard, menghapus komentar, atau membuka komentar di browser web di situs penyedia (seperti github.com atau situs proyek Azure DevOps Anda).

Kemampuan untuk menambahkan komentar ke permintaan pull terbatas untuk beberapa penyedia Git. Misalnya, dengan GitHub sebagai penyedia, Anda hanya dapat menambahkan komentar pada baris dalam 3 baris perubahan, tetapi dengan penyedia Azure DevOps, Anda dapat menambahkan komentar di setiap baris file yang terlibat dalam permintaan pull. Bagaimanapun, Anda hanya dapat menambahkan komentar pada file yang disertakan dalam permintaan pull.

Menampilkan komentar dalam tampilan berbeda

Anda dapat melihat komentar dalam tampilan berbeda serta tampilan file. Dalam tampilan berbeda, Anda dapat melihat komentar bersama kode asli dan yang diperbarui. Ini membuatnya lebih mudah untuk melihat dengan tepat apa yang diubah dan mengapa. Anda juga dapat mengedit file yang berfungsi secara langsung dalam tampilan ini.

Cuplikan layar komentar PR dalam tampilan berbeda.

Pemformatan markdown dalam komentar

Dalam tampilan file atau tampilan diff, komentar dirender menggunakan pemformatan Markdown.

Cuplikan layar komentar PR yang memperlihatkan pemformatan Markdown.

Gunakan keyboard

Anda dapat menavigasi di seluruh file dan komentar individual menggunakan ikon di toolbar, atau menggunakan pintasan keyboard berikut:

Perbuatan Pintasan papan ketik
Buka file sebelumnya dalam permintaan pull Ctrl+Shift+Alt+F6
Buka file berikutnya dalam permintaan pull Ctrl+Alt+F6
Masuk ke komentar sebelumnya Ctrl+Shift+Alt+F8
Masuk ke komentar berikutnya Ctrl+Alt+F8
Sembunyikan komentar dalam file Ctrl+Shift+F1

Langkah berikutnya

Untuk melanjutkan perjalanan Anda, kunjungi halaman Mengambil, menarik, dan menyinkronkan di Visual Studio.

Lihat juga