Android Gradle eklentisi Yükseltme Asistanı'nı kullanma

Android Gradle eklentisi (AGP) Yükseltme Asistanı, Android Studio'da projeniz tarafından kullanılan AGP sürümünü yükseltmenize yardımcı olan bir araçtır.

android skills add agp-9-upgrade

Derlemenizi yapılandırmaya yönelik yeni özellikler, diğer Gradle eklentileri tarafından kullanılacak yeni API'ler ve proje derlemesinin Android Studio ile entegrasyonunda yapılan iyileştirmelerle ilgili AGP değişiklikleri için sık sık yeni sürümler yayınlanır. Projeniz tarafından kullanılan AGP sürümünü yükselterek en yeni özelliklerden yararlanabilirsiniz.

Yükseltme Asistanı için önerilen proje yapısı hakkında daha fazla bilgi edinmek isterseniz bu sayfadaki Kurulum bölümüne bakın.

AGP Yükseltme Asistanı'nın kullanım alanları

AGP Upgrade Assistant, AGP sürümlerini yükseltmek için gereken değişiklikler konusunda size yol gösterir. Yükseltme Asistanı'nın en yaygın kullanım alanları şunlardır:

• Söz dizimi değişiklikleri: Upgrade Assistant, AGP'nin eski bir sürümü için derleme dosyalarınızı AGP'nin daha yeni bir sürümü için gereken dosyalara çevirmeye çalışır. AGP geliştirildikçe derleme dosyaları, zaman içinde değiştirilen, desteği sonlandırılan veya desteklenmeyen arayüzleri destekleyecek şekilde güncellenir.

• AGP ve Gradle arasındaki uyumluluk koşulları: Yükseltme asistanı, AGP ve Gradle arasındaki uyumluluk koşullarını bilir ve AGP sürümünüz için gereken Gradle sürümünü kullandığınızdan emin olmanıza yardımcı olur.

• AGP ve üçüncü taraf Gradle eklentileri arasındaki uyumluluk şartları: Yükseltme asistanı, AGP ile bazı üçüncü taraf Gradle eklentileri arasındaki uyumluluk şartlarını bilir ve AGP sürümünüz için gereken üçüncü taraf Gradle eklentilerinin sürümlerini kullandığınızdan emin olmanıza yardımcı olur.

Genel olarak, Yükseltme Yardımcısı, derleme dosyalarını güncellemeyi ve AGP yükseltmesinden sonra ilgili hata mesajlarını anlamayı kolaylaştırır. Yükseltme Asistanı, önerilen değişikliklerin neden gerekli olduğunu da açıklar.

AGP Upgrade Assistant'ı kullanma

Yükseltme Asistanı'nı kullanmak için proje yapınızın araca uygun olduğundan emin olun ve ardından Yükseltme Asistanı'nı çalıştırma bölümünde açıklandığı gibi Android Studio'dan çalıştırın.

Projenizi oluşturma

Yükseltme asistanını çalıştırmadan önce projenizin doğru şekilde biçimlendirildiğinden ve yedeklendiğinden emin olun. AGP Yükseltme Asistanı'nın doğru şekilde ayarlandığından emin olmak için aşağıdaki bölümleri okuyun.

Gradle derleme dosyalarını ve alana özgü dili kullanarak projenizi yapılandırma

AGP Yükseltme Asistanı'ndan en iyi şekilde yararlanmak için aşağıdakileri yapın:

• Derlemeyi Gradle derleme dosyalarını kullanarak yapılandırma: Yükseltme asistanı, Gradle derleme dosyalarının statik analizini kullanır. Yükseltme asistanından en iyi şekilde yararlanmak için bu derleme dosyalarını kullanarak derlemenizi yapılandırın. Projenizin gradle alt dizinindeki bir libs.versions.toml dosyasında tanımlanan bağımlılıklara ve eklentilere başvurmak için Gradle sürüm kataloglarını kullanın.

• Bildirim temelli derleme alanına özgü dili kullanın: Gradle derleme dosyaları Groovy veya Kotlin dilinde ifade edilir. Ancak proje yapılandırmasının ifadesi ne kadar açıklayıcı olursa Yükseltme Yardımcısı'nın yükseltme için ayarlanması gereken tüm yerleri başarıyla bulma olasılığı o kadar artar.

Proje bu sınırlamalara uysa bile Yükseltme Asistanı temiz bir yükseltme gerçekleştiremeyebilir. Hataları çözme veya bildirme konusunda rehberlik için Hataları giderme bölümüne bakın.

Projenizi yedekleme

Yükseltme Asistanı'nı kullanmadan önce projenizde sürüm denetim sisteminiz tarafından görülen, kaydedilmemiş değişiklikler olmamasını öneririz. Sürüm denetimi kullanmıyorsanız bu noktada bilinen son iyi sürümün yedeğini kullanın.

Yükseltme Asistanı çalıştırıldıktan ve proje başarıyla derlenip test edildikten sonra projenin yeni sürümünü sürüm denetim sisteminize kaydedebilirsiniz.

Yükseltme Asistanı'nı çalıştırma

Yükseltme asistanını çalıştırmak için aşağıdaki adımları uygulayın:

1. Yükseltme asistanını başlatmak için Tools > AGP Upgrade Assistant'a gidin veya Şekil 1'de gösterildiği gibi bildirim istemini tıklayın.

   Görüntülenen araç penceresinde, projenin mevcut AGP sürümü ve Android Studio'nun bu sürümü tarafından desteklenen en yeni sürüm de dahil olmak üzere varsayılan yükseltmenin ayrıntıları gösterilir.

   

2. Gerekli ve önerilen adımları kontrol edin.

   Sol panelde, onay kutularının bulunduğu ağaçta yükseltme işlemindeki adımlar ayrıntılı olarak açıklanır. Bu adımlar, güncellenmesi gereken veya önerilen adımlar ve diğer adımların ön koşulları olup olmadıklarına göre kategorilere ayrılır. Ana panelde her adımla ilgili daha fazla ayrıntı görüntülemek için ağaçtaki öğeleri tek tek seçin.

3. Yükseltmeyi çalıştırmak için gerekli ve istenen adımları seçip Seçili adımları çalıştır'ı tıklayın.

   Yükseltme Asistanı, proje derleme dosyalarını değiştirir ve yeni proje derlemesini Android Studio ile senkronize etmeye çalışır. Çok sayıda modülünüz varsa eklentilerin ve kitaplıkların yeni sürümlerinin indirilmesi gerekebileceğinden bu işlem biraz zaman alabilir.

4. Yükseltme sonrası raporunu inceleyin. Bu raporda, tamamlanan adımlar ve yükseltmenin başarılı olup olmadığı açıklanır. Yükseltme sonrasında projeyi derleme veya test etme konusunda sorun yaşarsanız yükseltme asistanı tarafından yapılan değişiklikleri geri alma işlemini de içerir.

5. Proje, Android Studio ile başarıyla senkronize edildikten sonra projeyi derleyin ve yükseltme işleminin herhangi bir işlevi değiştirmediğini doğrulamak için test paketlerini çalıştırın.

6. Projenizin iyi durumda olduğunu doğruladıktan sonra projenizin yeni sürümünü sürüm denetim sisteminize kaydedin.

Hataların giderilmesi

Yükseltme Asistanı bir yükseltme önerir ancak yükseltme başarısız olursa bu durum genellikle derleme dosyalarında değişiklik yapılması ve bunun sonucunda senkronizasyon hatası oluşmasından kaynaklanır. Hatayı tespit edip düzeltmek için aşağıdaki adımları uygulayın:

• Öncelikle senkronizasyon hatasına neden olan hatayı inceleyin. Bazen hatanın nedeni bellidir ve projenin derleme dosyalarında bu sorunu çözebilirsiniz.

• Hata mesajı net değilse veya soruna neyin neden olduğu açık değilse yükseltmeyi daha küçük adımlara bölmek için projeyi orijinal durumuna döndürün. Sürüm denetiminden veya yedeklerden orijinal durumu geri yükleyin ve projenin orijinal durumunda olduğundan ve Android Studio ile senkronize edildiğinden emin olun.

İki tür yükseltme dökümünü inceleyerek hatayı araştırın:

• En yeni sürüm olmayan farklı bir AGP sürümüne yükseltme Başarısız olan yükseltme işlemi çok sayıda sürümü kapsıyorsa sorunu izole etmenin en iyi yolu, sorunu tetikleyen ilk yükseltmeyi bulmak için sürümden sürüme bir dizi daha küçük yükseltme yapmaktır.

• Yükseltme işlemi sırasında adımları tek tek uygulayın. Sorunu tetikleyen yükseltmeyi belirledikten sonra yükseltmedeki adımları tek tek devre dışı bırakabilirsiniz. Bu mümkünse hataya hangi adımın neden olduğunu bulmak için her adımı tek tek deneyin. Soruna neden olan adımı bulamıyorsanız kullandığınız diğer Gradle eklentilerinin sürüm notlarında Gradle veya AGP ile uyumluluk sorunları olup olmadığını kontrol edin. Bazen yeni bir sürüm, kullanımdan kaldırılmış veya dahili API'lerin kullanımını ele alır.

• Hata bildirin. Bazen tüm hazırlık adımları ve senkronizasyon başarılı olur ancak son yükseltme adımı başarısız olur. Bu durumda lütfen hata bildirin. Hatayı kendiniz düzeltmeyi başarsanız bile, sorunun geliştirme ekibi tarafından ele alınabilmesi için orijinal hatayı hata izleyiciye bildirin.