Otomatik katalog güncellemeleri ve LSP entegrasyonu

Yazılım Tanımlı Araç (SDV) platformu, kod tabanında çok sayıda VSIDL kataloğu içerir. CATALOG_UPDATE dosyası, her katalog için merkezi bir yapılandırma sağlayarak hem otomatik güncellemeleri hem de IDE entegrasyonunu mümkün kılar.

CATALOG_UPDATE dosyasının rolü

CATALOG_UPDATE dosyasının iki temel amacı vardır:

  1. Otomatik güncellemeler: Dosya, derleyici veya bağımlılıklar değiştiğinde regenerator aracının sistemdeki tüm katalogları bulup yeniden derlemesine olanak tanır.
  2. Dil Sunucusu Protokolü (LSP) Desteği: VSIDL Dil Sunucusu, katalog kökünü bulmak ve bağımlılıkları çözmek için bu dosyayı kullanır. Bu sayede, diğer kataloglarda tanımlanan türler için "Tanıma Git", otomatik tamamlama ve gerçek zamanlı doğrulama gibi özellikler kullanılabilir.

Katalog yapılandırma

VSIDL kataloğu için otomatik güncellemeleri ve LSP desteğini etkinleştirmek istiyorsanız kataloğun kök dizininde bir CATALOG_UPDATE dosyası oluşturun. Bu dosya bir metin protobuf dosyasıdır.

Katalog yapılandırma alanları

  • output_path (dize, isteğe bağlı): Katalog kökünden, oluşturulan ara katman yazılımı kodunun yerleştirilmesi gereken dizine giden göreli yol.
  • dependency_catalog_paths (yinelenen dize): Diğer katalog dizinlerinin göreli yollarının listesi. LSP sunucusu, harici türleri çözümlemek için bu yolları kullanır.
  • vsidlc_gen_args (dize, isteğe bağlı): vsidlc yöntemine iletilen bağımsız değişkenler. LSP sunucusu, doğru doğrulama kurallarını (ör. "--apex") uygulamak için bunları inceler.
  • prebuilts_output_path (dize, isteğe bağlı): Oluşturulan çalışma zamanı yapılandırması önceden derlenmiş dosyalarının yolu.
  • prebuilts_filegroup (dize, isteğe bağlı): Önceden derlenmiş öğeler için Soong filegroup adı.

Örnek yapılandırma

# proto-file: //system/software_defined_vehicle/tools/regenerator/proto/catalog.proto
# proto-message: Catalog

output_path: ".."
dependency_catalog_paths: "../../../../../automotive_services/diagnostics/vsidl/v1"
vsidlc_gen_args: "--apex"

Otomatik güncellemelere neden ihtiyaç duyulur?

Her katalog için oluşturulan kodu manuel olarak yönetmek, çeşitli nedenlerle sorunludur:

  1. Derleyici güncellemeleri: Derleyici, hata düzeltmeleri veya yeni özelliklerle güncellendiğinde, tutarlılığı korumak için bir Android.bp dosyasında genrule tarafından kapsanmayan tüm oluşturulan kodlar ve dosyalar yenilenmelidir.
  2. Bağımlılık yönetimi: Temel katalogda yapılan değişiklikler genellikle alt katalogların yeniden oluşturulmasını gerektirir.
  3. Doğruluk: Otomatik güncellemeler, yolları ve bağımlılıkları belirtirken insan hatası riskini azaltır.

Yeniden oluşturma aracını çalıştırma

regenerator aracı, SDV kökünden başlayarak dizin ağacını tarar ve tam olarak CATALOG_UPDATE adlı dosyaları arar.

Yapılandırılmış tüm katalogları güncellemek için:

  1. Aracı derleyin:

    m regenerator

  2. Aracı çalıştırın:

    regenerator

    İsteğe bağlı olarak, belirli bir dizin için yinelemeli olarak çalıştırın: console regenerator --root /path/to/directory

Araç, oluşturulan dosyaları günceller ve değişikliklerin sistemin geri kalanıyla uyumlu olduğunu doğrulamak için tam derleme (m droid) gerçekleştirir.