Bireysel kullanıcılar için Gemini Code Assist ile kodlama

Bu belgede, VS Code veya IntelliJ ve diğer desteklenen JetBrains IDE'lerinde aşağıdaki işlemleri yapmanıza yardımcı olması için IDE'nizdeki yapay zeka destekli bir asistan olan Gemini Code Assist'i nasıl kullanabileceğiniz açıklanmaktadır:

  • Kod dönüştürme ile projeniz için kod oluşturun.
  • Kod yazarken kod tamamlamaları alın.
  • Akıllı işlemleri kullanın.

Gemini Code Assist Enterprise kullanıyorsanız Kod özelleştirme özelliğini kullanabilirsiniz. Bu özellik, kuruluşunuzun özel kod tabanına dayalı kod önerilerini doğrudan Gemini Code Assist Enterprise'dan almanızı sağlar. Kod özelleştirmeyi nasıl yapılandıracağınızı öğrenin.

Bu belge, her beceri düzeyinden geliştirici için hazırlanmıştır. VS Code veya IntelliJ ve desteklenen diğer JetBrains IDE'leri hakkında bilgi sahibi olduğunuz varsayılır. Ayrıca Android Studio'da Gemini'ı da kullanabilirsiniz.

Başlamadan önce

VS Code

  1. Henüz yapmadıysanız bireysel kullanıcılar için Gemini Code Assist, Gemini Code Assist Standard veya Gemini Code Assist Enterprise'ı kurun.

  2. Kod dosyanızda Gemini Code Assist özelliklerini test etmeden önce dosyanızın kodlama dilinin desteklendiğinden emin olun. Desteklenen kodlama dilleri hakkında daha fazla bilgi için Desteklenen kodlama dilleri başlıklı makaleyi inceleyin.

  3. IDE'nizi proxy arkasında kullanmayı tercih ediyorsanız Visual Studio Code'da Ağ Bağlantıları başlıklı makaleyi inceleyin.

IntelliJ

  1. Henüz yapmadıysanız bireysel kullanıcılar için Gemini Code Assist, Gemini Code Assist Standard veya Gemini Code Assist Enterprise'ı kurun.

  2. Kod dosyanızda Gemini Code Assist özelliklerini test etmeden önce dosyanızın kodlama dilinin desteklendiğinden emin olun. Desteklenen kodlama dilleri hakkında daha fazla bilgi için Desteklenen kodlama dilleri başlıklı makaleyi inceleyin.

  3. IDE'nizi proxy arkasında kullanmayı tercih ediyorsanız HTTP Proxy bölümüne bakın.

İstemlerle kod oluşturma

Aşağıdaki bölümlerde, Gemini Code Assist'i kullanarak kod dosyanızda Function to create a Cloud Storage bucket örnek istemiyle nasıl kod oluşturacağınız gösterilmektedir. Ayrıca kodunuzun bir bölümünü seçip sohbet özelliği aracılığıyla Gemini Code Assist'ten yardım isteyebilir, kod yazarken kod önerilerini alıp kabul edebilir veya reddedebilirsiniz.

Gemini Code Assist'e kod dönüştürme istemi gönderme

Kod dönüştürme, kodunuzda değişiklik isteğinde bulunmak için Hızlı Seçim menüsünde komutlar veya doğal dil istemleri kullanmanıza olanak tanır ve kodunuzda bekleyen değişiklikleri göstermek için bir farklılık görünümü sunar. Gemini Code Assist'e kod dönüştürme istemi göndermek için aşağıdaki adımları uygulayın:

VS Code

  1. Kod dosyanızda yeni bir satırda Control+I (Windows ve Linux için) veya Command+I (macOS için) tuşlarına basarak Gemini Code Assist Hızlı Seçim menüsünü açın.

  2. Menüde, /generate komutunu kullanarak /generate function to create a Cloud Storage bucket girin ve ardından Enter (Windows ve Linux için) veya Return (macOS için) tuşuna basın.

    Gemini Code Assist, /generate komutuyla kod oluşturur.

    Gemini Code Assist, isteminize göre kodu bir diff görünümünde oluşturur.

    Gemini Code Assist, oluşturulan kodu göstermek için bir farklılık görünümü açar.

  3. İsteğe bağlı: Bu değişiklikleri kabul etmek için Kabul et'i tıklayın.

IntelliJ

  1. Kod dosyanızda yeni bir satırda Alt+\ (Windows ve Linux için) veya Cmd+\ (macOS için) tuşlarına basarak Gemini Code Assist Hızlı Seçim menüsünü açın.

  2. Menüde, /generate komutunu kullanarak /generate function to create a Cloud Storage bucket girin ve ardından Enter (Windows ve Linux için) veya Return (macOS için) tuşuna basın.

    IntelliJ Gemini Code Assist'te kod dönüştürme işlevi oluşturma

    Gemini Code Assist, isteminize göre kodu bir diff görünümünde oluşturur.

    IntelliJ Gemini Code Assist'te kod dönüştürme farkı görünümü

  3. İsteğe bağlı: Bu değişiklikleri kabul etmek için Değişiklikleri Kabul Et'i tıklayın.

    IDE'nizde aşağıdaki kod dönüştürme komutlarını kullanabilirsiniz:

    • /fix: Kodunuzdaki sorunları veya hataları düzeltin. Örnek: /fix potential NullPointerExceptions in my code.
    • /generate: Kod oluşturun. Örnek: /generate a function to get the current time.
    • /doc: Kodunuza doküman ekleyin. Örnek: /doc this function.
    • /simplify: Kodunuzu basitleştirin. Örnek: /simplify if statement in this code.

Gemini Code Assist'e yorum içeren bir kod dosyasıyla istem girme

İsterseniz aşağıdaki adımları uygulayarak kod dosyanızda Gemini Code Assist'e yorumla da istem girebilirsiniz:

VS Code

  1. Yeni bir satırda yorumu Function to create a Cloud Storage bucket girin ve ardından Enter (Windows ve Linux için) veya Return (macOS için) tuşuna basın.

  2. Kod oluşturmak için Control+Enter (Windows ve Linux için) veya Control+Return (macOS için) tuşlarına basın.

    Gemini Code Assist, kod dosyanızdaki istem metninizin yanında hayalet metin şeklinde kodu oluşturur.

  3. İsteğe bağlı: Oluşturulan kodu kabul etmek için Sekme tuşuna basın.

IntelliJ

  1. Kod dosyanızda yeni bir satıra Function to create a Cloud Storage bucket yorumunu girin.

  2. Kod oluşturmak için Alt+G (Windows ve Linux için) veya Option+G (macOS için) tuşlarına basın. Alternatif olarak, yorumun yanını sağ tıklayıp Kod Oluştur'u seçebilirsiniz.

    Gemini Code Assist, yorumunuzun altındaki kodu hayalet metin biçiminde oluşturur.

  3. İsteğe bağlı: Oluşturulan kodu kabul etmek için Sekme tuşuna basın.

İsteğe bağlı: Kod oluşturma klavye kısayolunu değiştirme

Kod oluşturmak için varsayılan klavye kısayolu önceki bölümde belirtildiği gibi çalışmıyorsa klavye kısayolunu değiştirebilirsiniz.

Kod tamamlamaları alma

Kod yazarken Gemini Code Assist, satır içi kod önerileri (kod tamamlama olarak da bilinir) sunar. Bu önerileri kabul edebilir veya yoksayabilirsiniz. Kod tamamlama özelliğini kullanmak için aşağıdaki adımları uygulayın:

VS Code

  1. Kod dosyanızda yeni bir satırda işlev yazmaya başlayın. Örneğin, bir Python dosyasındaysanız def yazın.

    Gemini Code Assist, kodları hayalet metin şeklinde önerir.

  2. Gemini Code Assist'in kod önerisini kabul etmek için Sekme tuşuna basın. Aksi takdirde, öneriyi yok saymak için Esc tuşuna basın veya kodunuzu yazmaya devam edin.

IntelliJ

  1. Kod dosyanızda yeni bir satırda işlev yazmaya başlayın. Örneğin, bir Python dosyasındaysanız def yazın.

    Gemini Code Assist, satır içi öneri şeklinde kod önerir.

  2. Gemini Code Assist'in kod önerisini kabul etmek için Sekme tuşuna basın. Aksi takdirde, öneriyi yok saymak için Esc tuşuna basın veya kodunuzu yazmaya devam edin.

  3. İsteğe bağlı: Satır içi öneriyi kabul etmek için farklı bir kısayol tuşu kullanmayı tercih ederseniz işaretçinizi satır içi önerinin üzerine getirin ve görünen Tab açılır listesini tıklayın. Ardından, tercih ettiğiniz kısayolu seçin veya kendi kısayolunuzu girmek için Özel'i tıklayın.

    Gemini, satır içi öneriyi kabul etmek için kısayolunuzu değiştirebileceğiniz bir açılır menü sunar.

İsteğe bağlı: Kod tamamlama özelliğini devre dışı bırakma

Kod tamamlama özelliği varsayılan olarak etkindir. Kod tamamlama özelliğini devre dışı bırakmak istiyorsanız aşağıdaki adımları uygulayın:

VS Code

  1. IDE'nizde Code (macOS için) veya File'ı (Windows ve Linux için) tıklayın, ardından Settings > Settings'e gidin.

  2. Ayarlar iletişim kutusunun Kullanıcı sekmesinde Uzantılar > Gemini Code Assist'e gidin.

  3. Duet AI: Satır İçi Öneriler: Otomatik Olarak Etkinleştir listesini bulana kadar kaydırın ve Kapalı'yı seçin.

    Bu işlem, satır içi önerileri devre dışı bırakır. Yine de satır içi önerileri manuel olarak tetiklemek için Control+Enter (Windows ve Linux için) veya Control+Return (macOS için) tuşlarına basabilirsiniz.

IntelliJ

IDE'nizin durum çubuğunda spark Gemini Code Assist: Active'i (Gemini Kod Asistanı: Etkin) tıklayın ve Enable AI Code Completion'ı (Yapay Zeka Kod Tamamlama'yı Etkinleştir) seçin.

IntelliJ durum çubuğundaki Gemini Kod Tamamlama düğmesi.

Bu işlem, kod tamamlama ayarını devre dışı bırakır ve ayarı tekrar etkinleştirene kadar Gemini Code Assist satır içi önerilerde bulunmaz.

Uzak depo bağlamıyla daha alakalı öneriler alın

Gemini Code Assist'i belirli uzak depolara odaklanmaya yönlendirerek bağlama daha uygun ve alakalı kod önerileri alabilirsiniz. Sohbette @ sembolünü kullanarak istemleriniz için bağlamın birincil kaynağı olarak kullanılacak bir veya daha fazla depo seçebilirsiniz. Bu özellik, çoğunlukla belirli bir mikro hizmet, kitaplık veya modül grubuyla ilgili bir görev üzerinde çalışırken kullanışlıdır.

Bağlam olarak uzak bir depo kullanmak için IDE'nizin sohbetinde aşağıdaki adımları uygulayın:

  1. İsteminize @ simgesiyle başlayın. Dizinlenmiş kullanılabilir uzak depoların listesi gösterilir.
  2. Listeden bağlam için kullanmak istediğiniz depoyu seçin. Listeyi filtrelemek için depo adını yazmaya da başlayabilirsiniz.
  3. Depoyu seçtikten sonra isteminizin geri kalanını yazın.

Gemini Code Assist, yanıt oluştururken seçilen depoya öncelik verir.

Örnek İstemler

Bu bölümde, uzak depo bağlamıyla nasıl daha alakalı öneriler alabileceğinize dair örnekler yer almaktadır.

  • Depoyu anlama
    • @REPOSITORY_NAME What is the overall structure of this repository?
    • @REPOSITORY_NAME I'm a new team member. Can you give me an overview of this repository's purpose and key modules?
  • Kod oluşturma ve değiştirme
    • @REPOSITORY_NAME Implement an authentication function similar to the one in this repository.
    • @REPOSITORY_NAME Refactor the following code to follow the conventions in the selected repository.
    • Use the library-x in @REPOSITORY_A_NAME-A and implement the function-x
  • Test
    • @UNIT_TEST_FILE_NAME Generate unit tests for module-x based on the examples in the selected file.

Bağlam için odaklanılmış bir kaynak olarak uzak depoları kullanarak Gemini Code Assist'ten daha doğru ve alakalı öneriler alabilirsiniz. Bu öneriler, daha hızlı ve verimli bir şekilde kod yazmanıza yardımcı olabilir.

Akıllı işlemleri kullanma

Gemini Code Assist, bağlam değiştirme işlemini en aza indirirken daha üretken olmanıza yardımcı olmak için doğrudan kod düzenleyicinizde yapay zeka destekli akıllı işlemler sunar. Kod düzenleyicinizde kodunuzu seçtiğinizde, bağlamınızla alakalı işlemlerin listesini görüntüleyebilir ve bu listeden seçim yapabilirsiniz.

Kodunuzda akıllı işlemleri kullanmak için aşağıdaki adımları uygulayın:

VS Code

  1. Kod dosyanızda bir kod bloğu seçin.

  2. Seçilen kod bloğunun yanında lightbulb Show Code Actions'ı (Kod İşlemlerini Göster) tıklayın.

    VS Code'da bir kod bloğu seçildikten sonra akıllı işlemler ampul simgesi görünür.

  3. Birim testleri oluştur gibi bir işlem seçin.

    Gemini Code Assist, seçtiğiniz işleme dayalı bir yanıt oluşturur.

IntelliJ

  1. Kod dosyanızda bir kod satırı veya bloğu seçin.

  2. Seçili kodu sağ tıklayın ve Birim testleri oluştur gibi bir akıllı işlem seçin.

    Akıllı işlemi seçtiğinizde Gemini Code Assist, Gemini Code Assist araç penceresinde isteme otomatik olarak yanıt oluşturur.

Kod dönüştürme hızlı düzeltmesini kullanma

Kodunuzda hata varsa Gemini Code Assist, kod dönüştürme ile hataya hızlı düzeltme uygulama seçeneği sunar.

Kod dosyanızda hızlı düzeltme uygulamak için aşağıdaki adımları uygulayın:

VS Code

  1. Kod dosyanızda, imlecinizi dalgalı hata satırının üzerine getirin ve Hızlı Düzeltme'yi, ardından /fix'i seçin.

    Entegre geliştirme ortamında kod dönüştürme ile ilgili hızlı düzeltme.

  2. Hızlı düzeltme uygulandığında bir fark görünümü gösterilir. Bu değişiklikleri kabul etmek için Kabul et'i tıklayın.

IntelliJ

  1. Kod dosyanızda, kodunuzda hata olduğunu belirten kırmızı hata ampulü simgesini tıklayın ve Gemini ile düzelt'i seçin.

    IDE'de Gemini ile düzeltmek için kod dönüştürme seçeneği.

  2. Düzeltme uygulandığında bir farklılık görünümü gösterilir. Bu değişiklikleri kabul etmek için Kabul et'i tıklayın.

Dosyaları yerel bağlamdan hariç tutma

Varsayılan olarak, Gemini Code Assist, dosyalar bir .aiexclude veya .gitignore dosyasında belirtilmişse kod tamamlama, kod oluşturma, kod dönüştürme ve sohbet bağlamında yerel kullanımdan hariç tutar.

Dosyaları yerel kullanımdan nasıl hariç tutacağınızı öğrenmek için Dosyaları Gemini Code Assist kullanımından hariç tutma başlıklı makaleyi inceleyin.

Alıntılanan kaynaklarla eşleşen kod önerilerini devre dışı bırakma

Gemini Code Assist, başka bir kaynaktan (ör. mevcut açık kaynak kodu) doğrudan ve uzun alıntılar yaptığında alıntı bilgileri sağlar. Daha fazla bilgi için Gemini, yanıtlarındaki alıntıların kaynağını nasıl ve ne zaman belirtir? başlıklı makaleyi inceleyin.

Alıntılanan kaynaklarla eşleşen kodların size önerilmesini önlemek için aşağıdakileri yapın:

VS Code

  1. IDE'nizin etkinlik çubuğunda Yönet > Ayarlar'ı tıklayın.

  2. Ayarlar penceresinin Kullanıcı sekmesinde Uzantılar > Gemini Code Assist'e gidin.

  3. Geminicodeassist > Recitation: Max Cited Length'i (Geminicodeassist > Alıntı: Maksimum Alıntı Uzunluğu) bulana kadar ekranı kaydırın.

  4. Değeri 0 olarak ayarlayın.

Gemini Code Assist artık alıntılanan kaynaklarla eşleşen kodlar önermiyor.

IntelliJ

  1. IDE'nizin durum çubuğunda spark Gemini Code Assist: Active'i (Gemini Code Assist: Etkin) tıklayın ve Configure Gemini'ı (Gemini'ı yapılandır) seçin.

  2. Gelişmiş ayarlar bölümünü genişletin ve Harici alıntılanan kaynaklarla eşleşen seçimleri engelle'yi seçin.

  3. Tamam'ı tıklayın.

Gemini Code Assist artık alıntılanan kaynaklarla eşleşen kodlar önermiyor.

Bilinen sorunlar

Bu bölümde, Gemini Code Assist'in bilinen sorunları özetlenmektedir:

VS Code

  • Büyük bir açık dosyanın güncellenmiş sürümünü içeren sohbet yanıtları kısaltılabilir

    Bu sorunu çözmek için kodun daha küçük bir bölümünü seçin ve sohbet istemine only output the selected code. gibi ek bir yönerge ekleyin.

  • Vim: Ekleme modunda olmadığınız sürece kod oluşturma önerilerini kabul edemez veya kapatamazsınız

    Vim eklentisini normal modda kullanırken kod önerilerini kabul edemez veya kapatamazsınız.

    Bu sorunu gidermek için i tuşuna basarak ekleme moduna girin ve ardından Sekme tuşuna basarak öneriyi kabul edin.

  • Vim: Esc tuşuna basarak önerileri kapatırken tutarsız davranış

    Esc tuşuna bastığınızda hem IDE hem de Gemini Code Assist önerileri kapatılır. Bu davranış, Esc tuşuna basıldığında Gemini Code Assist'in yeniden tetiklendiği Vim dışı davranıştan farklıdır.

  • Oturum açma girişimlerinin zaman aşımına uğraması

    Oturum açma denemeleriniz zaman aşımına uğramaya devam ediyorsa settings.json dosyanıza cloudcode.beta.forceOobLogin ayarını eklemeyi deneyin:

     "cloudcode.beta.forceOobLogin": true

  • Lisans okuma uyarıları oturumlar arasında kalıcı olmuyor

    Lisans okuma uyarıları oturumlar arasında devam etmiyorsa kalıcı günlükleri inceleyin:

    1. Görünüm > Çıkış'ı tıklayın.

    2. Gemini Code Assist - Alıntılar'ı seçin.

  • Gemini Code Assist çıkış penceresindeki bağlantı sorunları

    Gemini Code Assist çıkış penceresinde bağlantı hatası veya başka bağlantı sorunları görürseniz şunları deneyin:

    • Güvenlik duvarınızı oauth2.googleapis.com ve cloudaicompanion.googleapis.com'ye erişime izin verecek şekilde yapılandırın.

    • Güvenlik duvarınızı, gRPC'nin kullandığı HTTP/2 üzerinden iletişime izin verecek şekilde yapılandırın.

    Bağlantıyı test etmek için grpc-health-probe aracını kullanabilirsiniz. Başarılı bir kontrolün sonucu aşağıdaki çıktıdır:

    $ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

    Başarısız bir kontrol aşağıdaki çıktıyı verir:

    timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

    Daha fazla bilgi edinmek için grpc-health-probe komutunu çalıştırmadan önce aşağıdakileri çalıştırın:

    export GRPC_GO_LOG_SEVERITY_LEVEL=info

IntelliJ

IntelliJ ve desteklenen diğer JetBrains IDE'leri için Gemini Code Assist ile ilgili bilinen bir sorun yoktur.

Geri bildirim gönder

Deneyiminizle ilgili geri bildirim bırakmak için aşağıdaki adımları uygulayın:

VS Code

  1. Geri bildiriminizi aşağıdaki yöntemlerden birini kullanarak gönderebilirsiniz:

    • Durum çubuğunda spark Gemini Code Assist'i tıklayın ve ardından Hızlı Seçim menüsünde Geri bildirim gönder'i seçin.
    • Komut Paleti'ni (Ctrl/Command + Shift + P) açın ve Gemini Code Assist: Geri Bildirim Gönder'i seçin.

  2. Formda Başlık ve Yorumlar alanlarını doldurun.

  3. Gemini Code Assist ile ilgili geri bildirim formunda, Geri bildirim kategorisi ve Tür açılır menülerinden bir seçenek belirleyin.

  4. Yorum alanına deneyiminizin ayrıntılı bir açıklamasını yazın.

  5. Geri bildirim raporunuza Gemini Code Assist günlüklerinizi eklediğinizden emin olun. Bu seçenek varsayılan olarak belirlenmiştir.

  6. Diğer seçeneklerden istediklerinizi işaretleyin veya işaretlerini kaldırın.

  7. Geri bildirim gönder'i tıklayın.

IntelliJ

  1. Durum çubuğunda spark Gemini Code Assist'i tıklayın.

  2. Sohbette Gemini Code Assist'i istemledikten sonra, yanıttan memnun kalmazsanız thumb_down Olumsuz'u tıklayın ve Geri bildirim gönder'i seçin.

  3. Formun üst kısmındaki metin alanına geri bildiriminizi girin.

  4. Gemini Code Assist günlüklerinizi paylaşmak istiyorsanız günlük dosyalarını seçtiğinizden emin olun.

  5. Geri bildirim gönder'i tıklayın.

Sırada ne var?