Tedarikçi Firma API düzeyi

Tedarikçi Firma API düzeyi, Google Ads tarafından desteklenen arayüzün sürümünü satıcı bölümü Arayüz çift yönlüdür; API'yi açıklıyor tarafından sağlanan, tedarikçi firma bölümünün sistem bölümüne (donanım soyutlama katmanı veya HAL arayüzü) ve ayrıca tedarikçi bölümünün alt seviyedeki yerel geliştirici kiti veya LLNDK arayüzü).

Tedarikçi Firma API düzeyi, Tedarikçi firma Yazılımı Gereksinimlerini belirlemek için de kullanılır. (VSR) önceliklendirme ve fonksiyonel ve işlevsel olmayan gerekliliklerin tedarikçi bölümündeki yazılımın gereksinimlerini karşılaması gerekir.

Bu sayfanın geri kalanında, özellikleri, tedarikçi firmayı belirlemek için Android sürümünüze bağlı olarak API düzeyi.

Satıcının donması

Android, bir tedarikçinin belirli bir sürümdeki tedarikçi firma bölümünü dondurmasına izin verir. VSR. Set Android'in satıcı bölümünden beklediği özelliklerin, Tedarikçi firma bölümü ile ilişkili tedarikçi firma API düzeyi. Çalışma zamanında, davranış sistem bölümünde çalışan yazılımın boyutu Tedarikçi firma bölümünün satıcı API düzeyi. Örneğin, sistem bölümü, Tedarikçi bölümünün API düzeyi.

Tedarikçi firma dondurma seçeneğini yalnızca bir Android uyumlu cihaz.

Tedarikçi firma API düzeyini belirleme (Android 14-QPR3 ve sonraki sürümler)

Android 14-QPR3 ve sonraki sürümlerde tedarikçi firma API düzeyi: ayrı olarak yayınlanır (yani SDK API düzeyi ve API düzeyi senkronize değil.

Ayrı sürüm planları nedeniyle 14-QPR3 ve sonraki sürümlerde, tedarikçi API düzeyi tamamen SDK API düzeyinden ayrılmıştır. Bu ayırmanın açık olmasını sağlamak için tedarikçi firma API düzeyinin biçimi, YYYYAA (yıl ve ay) olarak biçimlendirilmiş bir tarihtir SDK düzeyi ise tam sayıdır.

Android 14-QPR3 ve sonraki sürümler aşağıdaki sistemi içerir tedarikçi firma API düzeyiyle (ro.vendor.api_level) ilgili mülkler:

Sistem özelliği Biçim Açıklama İlk ayar
ro.board.api_level YYYYAA Yonga seti yazılımının desteklediği tedarikçi firma API düzeyi. Bu özellik tüm yonga setleri için ayarlanmıştır. Bu, derleme sistemi tarafından otomatik olarak ayarlanır.
ro.board.first_api_level YYYYAA Yonga seti yazılımının ilk kez kullanıma sunulduğu tedarikçi firma API düzeyi. Bu özellik yalnızca yonga setinin bir işlevidir ve SoC yonga seti satıcının dondurma işlemine uygun olması durumunda SoC satıcıları tarafından ayarlanır. İlk ayardan sonra değiştirilmemelidir. SoC tedarikçi firmaları bu ayarı BOARD_SHIPPING_API_LEVEL kullanarak belirler.
ro.product.first_api_level Tam sayı Cihazın başlangıçta kullanıma sunulduğu SDK API düzeyi. Bu özellik, OEM tarafından ayarlanır ve işletim sistemi yükseltmelerinden sonra bile hiçbir zaman güncellenmez.
ro.vendor.api_level YYYYAA Cihazın bir bütün olarak uyması gereken tedarikçi API düzeyi. Bu tablodan sonra açıklanmıştır.
ro.board.api_frozen Boole ro.board.api_level ürününün temsil ettiği tedarikçi API düzeyi kesinleşmişsa bu özellik, true olarak ayarlanır. Bu özellik ayarlanmazsa varsayılan olarak false olur.
ro.llndk.api_level YYYYAA Sistem bölümündeki geçerli LLNDK'nın sağladığı YYYYAA biçiminin tedarikçi firma API'sı düzeyi. LLNDK geriye dönük uyumludur. Bu nedenle, bu API düzeyinden düşük veya ona eşit olan tüm tedarikçi firma görüntüleri, bu sistem görüntüsüyle güncellenebilir. Bu özellik, sistem bölümü tarafından ayarlanır.

ro.vendor.api_level özelliği, aşağıdaki iki yöntemden biriyle türetilir:

  • Yonga seti, satıcının donması için gerekli niteliklere sahipse:

    ro.vendor.api_level = min(
      ro.board.api_level,
      AVendorSupport_getVendorApiLevelOf(ro.product.first_api_level))
    
  • Yonga seti, satıcı dondur ayarı kapsamında değilse:

    ro.vendor.api_level =
      AVendorSupport_getVendorApiLevelOf(ro.product.first_api_level)
    

AVendorSupport_getVendorApiLevelOf() yöntemi, dönüşüm izleme işlemini tedarikçi firma API'si düzeyini seçin. Örneğin: AVendorSupport_getVendorApiLevelOf(35); burada 35, 2024'teki önemli Android sürümü 202404 Mevcut Vendor API düzeyi önceki Android 14-QPR3 ayarlandı.

Tedarikçi firma API seviyesini belirleme (Android 13)

Tedarikçi firma API düzeyi, uygulama işletim sistemi için olan SDK API düzeyini takip eder arayüz üzerinde çalışır ve yeni Android platformu yayınlandığında yılda bir kez güncellenir. AOSP'ye.

Android 13'te aşağıdaki sistem bulunur tedarikçi firma API düzeyiyle (ro.vendor.api_level) ilgili mülkler:

Sistem özelliği Biçim Açıklama İlk ayar
ro.board.first_api_level Tam sayı Yonga seti yazılımının ilk kez kullanıma sunulduğu tedarikçi firma API düzeyi. Bu yalnızca yonga setinin bir işlevidir ve SoC satıcıları ya da OEM'ler tarafından değiştirilemez. Bu özellik, yalnızca satıcının donmasına uygun olan yonga setleri için ayarlanmıştır Değer, device.mk dosyasında BOARD_SHIPPING_API_LEVEL ayarlanarak belirlenir.
ro.board.api_level Tam sayı Yonga seti yazılımının desteklediği tedarikçi firma API düzeyi. Bu özellik, yalnızca satıcının dondurma işlemine uygun olan yonga setleri için ayarlanmıştır. Bu özellik tüm yonga setleri için ayarlanmıştır. Başlangıçta bu mülkün değeri, derleme sistemi tarafından ro.board.first_api_level ile aynı değere ayarlanır, ancak tedarikçi bölümü yükseltilirse güncellenebilir.
ro.product.first_api_level Tam sayı Cihazın başlangıçta kullanıma sunulduğu SDK API düzeyi. Bu özellik, OEM tarafından ayarlanır ve işletim sistemi yükseltmelerinden sonra bile hiçbir zaman güncellenmez.
ro.vendor.api_level Tam sayı Cihazın bir bütün olarak uyması gereken tedarikçi API düzeyi. Bu tablodan sonra açıklanmıştır.
ro.vndk.version Tam sayı Tedarikçi firma bölümünün temel aldığı VNDK sürümü. Bu özellik, sistem bölümü tarafından ayarlanır.
ro.vendor.build.version.sdk Tam sayı Tedarikçi bölümünün oluşturulduğu kaynak ağacın SDK API düzeyi.
ro.vendor.build.version.release Tam sayı Tedarikçi bölümünün oluşturulduğu kaynak ağacın platform sürümü.
ro.vendor.build.version.release_or_codename Tam sayı Tedarikçi bölümünün oluşturulduğu kaynak ağacın kod adı.

ro.vendor.api_level özelliği otomatik olarak en düşük ro.board.api_level (veya ro.board.api_level tanımlanmamışsa ro.board.first_api_level) değerine ayarlanır ve ro.product.first_api_level.