27 Mart 2025'ten itibaren AOSP'yi derlemek ve AOSP'ye katkıda bulunmak için aosp-main yerine android-latest-release kullanmanızı öneririz. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleyi inceleyin.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Android'e yeni piksel biçimleri ekleme

Android'e eklenen tüm yeni piksel biçimleri Android Arayüz Tanımlama Dili (AIDL) ve Android Donanım Arabelleği'ne (AHB) eklenmelidir. AIDL ve AHB, işlevselliği genişletirken dikkatli bir süreç gerektiren katı kararlılık ve standartlaştırma koşullarına sahiptir. Tüm yeni piksel biçimleri AOSP'ye eklenmeli ve tüm güncellemeler AIDL ve AHB uzmanları tarafından ayrı ayrı onaylanmalıdır. Bu dikkatli onay süreci, platformdaki yeni piksel biçimlerinin standartlaştırılmasında önemli bir faktördür.

Bu sayfada, gerekli AOSP kod değişiklikleri ve AOSP'ye yeni piksel biçimleri eklemek için gereken işlemler özetlenmiştir.

Yeni bir piksel biçimi eklemeden önce kaynağı indirin ve Yama gönderme bölümünde açıklandığı şekilde yamaları yükleyin.

AIDL'ye yeni bir piksel biçimi ekleme

Yeni bir piksel biçimi için destek eklemek, AIDL'de bulunan her iki PixelFormat.aidl dosyasında da değişiklik yapılmasını gerektirir. AIDL kaynak kodu için hardware/interfaces/graphics/common/aidl/ bölümüne bakın.

AIDL'ye yeni bir piksel biçimi eklemek için aşağıdaki adımları uygulayın:

Mevcut kod kuralını uygulayarak ve girişinizin onaltılık değerini önceki girişten bir fazla olacak şekilde ayarlayarak yeni piksel biçimini PixelFormat.aidl içindeki PixelFormat enum'un sonuna yeni bir giriş olarak ekleyin. Kod değişikliklerinizi önceki girişlerle eşleştirin. RGBA_8888 piksel biçimi girişi için aşağıdaki örneğe bakın:

/**
 * 32-bit format that has 8-bit R, G, B, and A components, in that order,
 * from the lowest memory address to the highest memory address.
 *
 * The component values are unsigned normalized to the range [0, 1], whose
 * interpretation is defined by the dataspace.
 */
RGBA_8888 = 0x1,

PixelFormat.aidl dosyasında değişiklik yaptıktan sonra kodu derlediğinizde aşağıdaki hata mesajı gösterilir:

android_developer:~/android/aosp-android-latest-release: m
...
###############################################################################
# ERROR: AIDL API change detected                                             #
###############################################################################
Above AIDL file(s) has changed. Run `m android.hardware.graphics.common-update-api` to reflect the changes
to the current version so that it is reviewed by
android-aidl-api-council@google.com
And then you need to change dependency on android.hardware.graphics.common-V(n)-* to android.hardware.graphics.common-V(n+1)-* to use
new APIs.

Bu hatayı düzeltmek için aidl_api dizininde PixelFormat.aidl değerini değiştirmek üzere hata mesajında belirtildiği gibi aşağıdaki komutu çalıştırın:
```
m android.hardware.graphics.common-update-api
```
Yukarıdaki komutu çalıştırarak normal şekilde derlenebilmesi için doğru dosyayı güncelleyin.

Not: Bu dosyayı manuel olarak düzenlemeye çalışmayın.

AHB'ye yeni bir piksel biçimi ekleme

Yeni bir piksel biçimi için destek eklemek hardware_buffer.h ve AHardwareBuffer.cpp dosyalarında değişiklik yapılmasını gerektirir. AHB kaynak kodu için frameworks/native/libs/nativewindow bölümüne bakın.

AHB'ye yeni bir piksel biçimi eklemek için aşağıdaki adımları uygulayın:

hardware_buffer.h dosyasında, yeni piksel biçimini AHardwareBuffer_Format enum'unun sonuna yeni bir giriş olarak ekleyin. Mevcut kod kurallarına uyun.
RGBA_8888 piksel biçimi örneğini kullanarak yeni piksel biçimi girişini aşağıdaki gibi ekleyin:
```
/**
 * Corresponding formats:
 *   Vulkan: VK_FORMAT_R8G8B8A8_UNORM
 *   OpenGL ES: GL_RGBA8
 */
AHARDWAREBUFFER_FORMAT_R8G8B8A8_UNORM = 1,
```
Yeni piksel biçimine AHB'de bir ad verildiğini unutmayın. Bu ad AHARDWAREBUFFER_FORMAT_ ile başlamalı, ardından kanal kısaltmaları ve bit derinlikleri gelmelidir. Ardından kodlama gelmelidir. Bu enum girişi, PixelFormat.aidl ile aynı onaltılık değere sahip olmalıdır.

Piksel biçiminin, ilişkili bir Vulkan veya OpenGL ES biçiminden birine veya her ikisine de sahip olması gerekir. Uygun durumlarda ilişkili biçimi belirtin. İlişkili bir biçim yoksa N/A değerini belirtin.
İlişkili bir OpenGL ES biçimi varsa piksel biçimini CTS kapsamındaki isteğe bağlı testlere ekleyin. Bunu yapmak için yeni GL biçimini AHBFormatAsString(int32_t format) içindeki AHardwareBufferGLTest.cpp alanına FORMAT_CASE(...) ve yeni biçim için GL_FORMAT_CASE(...) ile ekleyin. Aşağıda gösterildiği gibi:
```
const char* AHBFormatAsString(int32_t format) {
  switch (format) {
      ...
      FORMAT_CASE(R8G8B8A8_UNORM);
      ...
      GL_FORMAT_CASE(GL_RGB8);
  }
  return "";
}
```

Ardından, AHardwareBufferGLTest.cpp alanına aşağıdaki gibi gösterilen yeni bir test ekleyin:

class RGBA8Test : public AHardwareBufferGLTest {};

// Verify that if we can allocate an RGBA8 AHB we can render to it.
TEST_P(RGBA8Test, Write) {
    AHardwareBuffer_Desc desc = GetParam();
    desc.usage = AHARDWAREBUFFER_USAGE_GPU_FRAMEBUFFER;
    if (!SetUpBuffer(desc)) {
        return;
    }

    ASSERT_NO_FATAL_FAILURE(SetUpFramebuffer(desc.width, desc.height, 0, kBufferAsRenderbuffer));
    ASSERT_NO_FATAL_FAILURE(
        SetUpProgram(kVertexShader, kColorFragmentShader, kPyramidPositions, 0.5f));

    glDrawArrays(GL_TRIANGLES, 0, kPyramidVertexCount);
    ASSERT_EQ(GLenum{GL_NO_ERROR}, glGetError());
}

INSTANTIATE_TEST_CASE_P(
    SingleLayer, RGBA8Test,
    ::testing::Values(
        AHardwareBuffer_Desc{57, 33, 1, AHARDWAREBUFFER_FORMAT_R16G16_UINT, 0, 0, 0, 0}),
    &GetTestName);

En az bir AHardwareBuffer_Desc değer grubu belirtin. Gerekirse daha fazla değer ekleyin.

AHardwareBuffer.cpp dosyasında, aşağıdakiler arasında bulunan statik iddiaların sonunu bulun:

// ----------------------------------------------------------------------------
// Validate hardware_buffer.h and PixelFormat.aidl agree
// ----------------------------------------------------------------------------

Yeni piksel biçimi için HAL_PIXEL_FORMAT sabit değerini değil, PixelFormat:: enum'unu kullanarak yeni bir static_assert ekleyin. AIDL'ye yeni piksel biçimi ekleme bölümündeki RGBA_8888 piksel biçimi örneğini kullanarak yeni piksel biçimi girişini aşağıdaki gibi ekleyin:

static_assert(static_cast(aidl::android::hardware::graphics::common::PixelFormat::RGBA_8888) ==
  AHARDWAREBUFFER_FORMAT_R8G8B8A8_UNORM,
"HAL and AHardwareBuffer pixel format don't match");

Yeni piksel biçimini AHardwareBufferTest.cpp içindeki PrintAhbFormat() öğesinin sonuna ekleyerek uygun testlere ekleyin. Aşağıda gösterildiği gibi mevcut kod kurallarını uygulayın:
```
void PrintAhbFormat(std::ostream& os, uint64_t format) {
    switch (format) {
        ...
        FORMAT_CASE(R8G8B8A8_UNORM);
        default: os << "unknown"; break;
    }
}
```
Yeni piksel biçimini HardwareBuffer.java'deki HardwareBuffer SDK'sına ekleyin: @IntDef dosyasına yeni bir giriş ekleyerek. Örneğin, RGBA_8888 biçimi için giriş aşağıdaki gibi gösterilir:
```
@Retention(RetentionPolicy.SOURCE)
@IntDef(prefix = { "RGB", "BLOB", "YCBCR_", "D_", "DS_", "S_" }, value = {
  ...
  RGBA_8888,
})
```
Bileşen değerleri imzalanmamışsa normalleştirilmemişse değeri değişken adında açıkça belirtin. Örneğin, işaretsiz tam sayı 16 bit yalnızca kırmızı kanal biçiminin değişken adı R_16UI, ek bir işaretsiz tam sayı 16 bit yeşil kanal biçimi içeren aynı biçimin adı ise RG_16UI16UI olmalıdır.
@Format'in sonuna yeni bir herkese açık üye değişkeni ekleyerek yeni piksel biçimini HardwareBuffer.java içinde static int olarak ekleyin:
```
@Format
...
/** Format: 8 bits each red, green, blue, alpha */
public static final int RGBA_8888 = 0x1;
```
Bu enum girişi, PixelFormat.aidl ve hardware_buffer.h ile aynı onaltılık değere sahip olmalıdır. Mevcut kurallara uyun.

Bu kod değişiklikleriyle derleme yapmaya çalıştığınızda derleme hatası oluşur:

android_developer:~/android/aosp-android-latest-release: m
...
******************************
You have tried to change the API from what has been previously approved.

To make these errors go away, you have two choices:
   1. You can add '@hide' javadoc comments (and remove @SystemApi/@TestApi/etc)
      to the new methods, etc. shown in the above diff.

   2. You can update current.txt and/or removed.txt by executing the following command:
         m api-stubs-docs-non-updatable-update-current-api

      To submit the revised current.txt to the main Android repository,
      you will need approval.
******************************
...

Bu hatayı temizlemek için hata mesajında belirtildiği gibi aşağıdaki komutu çalıştırarak current.txt değerini değiştirin:

m api-stubs-docs-non-updatable-update-current-api

Yukarıdaki komutu çalıştırarak normal şekilde derlenebilmesi için doğru dosyayı güncelleyin.

Yeni piksel biçimini HardwareBufferTest.java içindeki paramsForTestCreateOptionalFormats() öğesinin sonuna ekleyerek Java testlerine ekleyin. Bu işlem aşağıdaki gibi gösterilmiştir:
```
private static Object[] paramsForTestCreateOptionalFormats() {
  return new Integer[]{
      HardwareBuffer.RGBA_8888
  };
```

Pencere sistemi entegrasyonuna yeni bir piksel biçimi ekleme

Yeni piksel biçimini bir grafik API'sindeki çerçeve önbelleği biçimi olarak kullanmak için ilgili grafik API'si için uygun Pencere Sistemi Entegrasyonu'na (WSI) ekleyin. Vulkan API'yi kullanan bir uygulama veya sistem işlemi için Vulkan Swapchain'i güncelleyin. OpenGL ES API'yi kullanan bir uygulama veya sistem işlemi için EGL API'yi güncelleyin.

Yeni piksel biçimleri için Vulkan WSI değişiklikleri

Vulkan WSI'yi aşağıdaki şekilde güncelleyin:

swapchain.cpp içindeki GetNativePixelFormat(VkFormat format) işlevine yeni bir durum ekleyin:

android::PixelFormat GetNativePixelFormat(VkFormat format) {
  ...
  switch (format) {
      ...
      case VK_FORMAT_R8G8B8A8_UNORM:
          native_format = PixelFormat::RGBA_8888;
          break;
      ...
      default:
          ALOGV("unsupported swapchain format %d", format);
          break;
  }
  return native_format;
}

Piksel biçiminin çalışması için Vulkan uzantısı gerekiyorsa Vulkan uzantısını sorgulayın. Örneğin, yan uzantılar için aşağıdaki gibi gösterilen instance_data simgesini kullanın:

bool colorspace_ext = instance_data.hook_extensions.test(ProcHook::EXT_swapchain_colorspace);

Cihaz tarafı uzantılar için aşağıdakileri kullanın:

bool rgba10x6_formats_ext = false;
uint32_t exts_count;
const auto& driver = GetData(pdev).driver;
driver.EnumerateDeviceExtensionProperties(pdev, nullptr, &exts_count,
                                          nullptr);
std::vector props(exts_count);
driver.EnumerateDeviceExtensionProperties(pdev, nullptr, &exts_count,
                                          props.data());
for (uint32_t i = 0; i < exts_count; i++) {
    VkExtensionProperties prop = props[i];
    if (strcmp(prop.extensionName,
               VK_EXT_RGBA10X6_FORMATS_EXTENSION_NAME) == 0) {
        rgba10x6_formats_ext = true;
    }
}

Google, bir örneği veya cihaz uzantısını swapchain.cpp'e göstermek için gereken altyapıyı yönetir. Vulkan yükleyicisinden uzantıların doğru şekilde ayarlanması için ilk değişiklik listesi gerekli değildir.

Ardından, biçim ve renk alanı çiftlerini listeleyin:

desc.format = AHARDWAREBUFFER_FORMAT_R10G10B10A10_UNORM;
if (AHardwareBuffer_isSupported(&desc) && rgba10x6_formats_ext) {
  all_formats.emplace_back(
      VkSurfaceFormatKHR{VK_FORMAT_R10X6G10X6B10X6A10X6_UNORM_4PACK16,
                         VK_COLOR_SPACE_SRGB_NONLINEAR_KHR});
  if (colorspace_ext) {
    all_formats.emplace_back(
        VkSurfaceFormatKHR{VK_FORMAT_R10X6G10X6B10X6A10X6_UNORM_4PACK16,
                           VK_COLOR_SPACE_PASS_THROUGH_EXT});
    all_formats.emplace_back(
        VkSurfaceFormatKHR{VK_FORMAT_R10X6G10X6B10X6A10X6_UNORM_4PACK16,
                           VK_COLOR_SPACE_DISPLAY_P3_NONLINEAR_EXT});
}

Uyumlu biçim ve renk alanı çiftleri hakkında bilgi sahibi olmanız gerekir.

Yeni biçimi external/deqp adresindeki dEQP-VK alanına ekleyin.
Gerekli değişiklikleri mevcut kaynaktan çıkararak veya Android destek ekibinize ulaşarak vktApiExternalMemoryTests.cpp ve vktExternalMemoryUtil.cpp'teki Vulkan Uygunluk Testlerini güncelleyin.

Yeni piksel biçimleri için EGL değişiklikleri

EGL'yi aşağıdaki gibi güncelleyin:

getNativePixelFormat() işlevinde, if-else ağacını yeni piksel biçimi için AIDL enum'unu döndürecek şekilde değiştirin. RGBA_8888 piksel biçimi örneğini kullanarak:

if (a == 0) {
  ...
} else {
  if (componentType == EGL_COLOR_COMPONENT_TYPE_FIXED_EXT) {
      if (colorDepth > 24) {
          ...
      } else {
          *format = PixelFormat::RGBA_8888;
      }
  } else {
    ...
  }
}

Yeni biçimi dEQP'ye eklemek için aşağıdaki gibi gösterilen androidFormatsenum'e yeni bir giriş ekleyin:
```
static const GLenum androidFormats[] =
{
  ...
  GL_RGBA8,
  ...
};
```

Güncellemenizi gönderme

Değişiklik listelerinizi oluşturmak ve uygun ekiple paylaşmak için Katkıda bulunanlar için bölümünü inceleyin.