অ্যান্ড্রয়েডে ভলকান বৈধতা স্তর

বেশিরভাগ সুস্পষ্ট গ্রাফিক্স এপিআই ত্রুটি-পরীক্ষা করে না কারণ এটি করার ফলে একটি কর্মক্ষমতা জরিমানা হতে পারে। ভলকানের বৈধতা স্তর রয়েছে যা বিকাশের সময় ত্রুটি-পরীক্ষা প্রদান করে, আপনার অ্যাপের প্রকাশের বিল্ডে কার্যক্ষমতার শাস্তি এড়িয়ে যায়। বৈধকরণ স্তরগুলি একটি সাধারণ উদ্দেশ্য লেয়ারিং প্রক্রিয়ার উপর নির্ভর করে যা API এন্ট্রি পয়েন্টগুলিকে বাধা দেয়।

একক Khronos বৈধতা স্তর

পূর্বে, ভলকান একাধিক বৈধতা স্তর সরবরাহ করেছিল যা একটি নির্দিষ্ট ক্রমে সক্ষম করা প্রয়োজন। 1.1.106.0 Vulkan SDK রিলিজ থেকে শুরু করে, আপনার অ্যাপটিকে শুধুমাত্র একটি একক বৈধতা স্তর সক্রিয় করতে হবে, VK_LAYER_KHRONOS_validation , পূর্ববর্তী বৈধতা স্তরগুলি থেকে সমস্ত বৈশিষ্ট্য পেতে৷

আপনার APK এ প্যাকেজ করা বৈধতা স্তরগুলি ব্যবহার করুন৷

আপনার APK এর মধ্যে প্যাকেজিং যাচাইকরণ স্তরগুলি সর্বোত্তম সামঞ্জস্য নিশ্চিত করে৷ বৈধতা স্তরগুলি পূর্বনির্মাণ বাইনারি হিসাবে উপলব্ধ বা উত্স কোড থেকে তৈরি করা যায়।

পূর্বনির্মাণ বাইনারি ব্যবহার করুন

GitHub রিলিজ পৃষ্ঠা থেকে সর্বশেষ Android Vulkan বৈধতা স্তর বাইনারি ডাউনলোড করুন।

আপনার APK-এ স্তরগুলি যুক্ত করার সবচেয়ে সহজ উপায় হল আপনার মডিউলের src/main/jniLibs/ ডিরেক্টরিতে পূর্বনির্মাণ করা লেয়ার বাইনারিগুলিকে বের করা, ABI ডিরেক্টরিগুলি (যেমন arm64-v8a বা x86-64 ) অক্ষত, এইভাবে:

src/main/jniLibs/
  arm64-v8a/
    libVkLayer_khronos_validation.so
  armeabi-v7a/
    libVkLayer_khronos_validation.so
  x86/
    libVkLayer_khronos_validation.so
  x86-64/
    libVkLayer_khronos_validation.so

সোর্স কোড থেকে বৈধতা স্তর তৈরি করুন

বৈধতা লেয়ার সোর্স কোডে ডিবাগ করতে, Khronos Group GitHub সংগ্রহস্থল থেকে সর্বশেষ উৎসটি টেনে আনুন এবং সেখানে বিল্ড নির্দেশাবলী অনুসরণ করুন।

যাচাইকরণ স্তরটি সঠিকভাবে প্যাকেজ করা হয়েছে

আপনি খ্রোনোস প্রি-বিল্ট লেয়ার বা সোর্স থেকে তৈরি লেয়ার দিয়ে তৈরি করুন না কেন, বিল্ড প্রসেস আপনার APK-এ একটি চূড়ান্ত ফাইল স্ট্রাকচার তৈরি করে যেমন নিচের মত:

lib/
  arm64-v8a/
    libVkLayer_khronos_validation.so
  armeabi-v7a/
    libVkLayer_khronos_validation.so
  x86/
    libVkLayer_khronos_validation.so
  x86-64/
    libVkLayer_khronos_validation.so

নিম্নোক্ত কমান্ডটি দেখায় কিভাবে যাচাই করা যায় যে আপনার APK-এ প্রত্যাশিতভাবে বৈধতা স্তর রয়েছে:

$ jar -tf project.apk | grep libVkLayer
lib/x86_64/libVkLayer_khronos_validation.so
lib/armeabi-v7a/libVkLayer_khronos_validation.so
lib/arm64-v8a/libVkLayer_khronos_validation.so
lib/x86/libVkLayer_khronos_validation.so

উদাহরণ তৈরির সময় একটি বৈধতা স্তর সক্ষম করুন

ভলকান এপিআই একটি অ্যাপকে উদাহরণ তৈরির সময় স্তরগুলি সক্ষম করার অনুমতি দেয়। এন্ট্রি পয়েন্ট যা একটি লেয়ার ইন্টারসেপ্টে প্রথম প্যারামিটার হিসাবে নিম্নলিখিত অবজেক্টগুলির মধ্যে একটি থাকতে হবে:

  • VkInstance
  • VkPhysicalDevice
  • VkDevice
  • VkCommandBuffer
  • VkQueue

উপলব্ধ স্তর এবং তাদের বৈশিষ্ট্য তালিকাভুক্ত করতে vkEnumerateInstanceLayerProperties() কল করুন। vkCreateInstance() চালানো হলে Vulkan স্তরগুলি সক্রিয় করে।

নিম্নলিখিত কোড স্নিপেট দেখায় কিভাবে একটি অ্যাপ প্রোগ্রাম্যাটিকভাবে প্রশ্ন করতে এবং স্তরগুলি সক্ষম করতে Vulkan API ব্যবহার করতে পারে:

// Enable just the Khronos validation layer.
static const char *layers[] = {"VK_LAYER_KHRONOS_validation"};

// Get the layer count using a null pointer as the last parameter.
uint32_t instance_layer_present_count = 0;
vkEnumerateInstanceLayerProperties(&instance_layer_present_count, nullptr);

// Enumerate layers with a valid pointer in the last parameter.
VkLayerProperties layer_props[instance_layer_present_count];
vkEnumerateInstanceLayerProperties(&instance_layer_present_count, layer_props);

// Make sure selected validation layers are available.
VkLayerProperties *layer_props_end = layer_props + instance_layer_present_count;
for (const char* layer:layers) {
  assert(layer_props_end !=
  std::find_if(layer_props, layer_props_end, [layer](VkLayerProperties layerProperties) {
    return strcmp(layerProperties.layerName, layer) == 0;
  }));
}

// Create a Vulkan instance, requesting all enabled layers or extensions
// available on the system
VkInstanceCreateInfo instanceCreateInfo{
  .sType = VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO,
  .pNext = nullptr,
  .pApplicationInfo = &appInfo,
  .enabledLayerCount = sizeof(layers) / sizeof(layers[0]),
  .ppEnabledLayerNames = layers,

ডিফল্ট লগক্যাট আউটপুট

বৈধকরণ স্তরটি একটি VALIDATION ট্যাগ সহ লেবেলযুক্ত লগক্যাটে সতর্কতা এবং ত্রুটি বার্তা নির্গত করে৷ একটি বৈধতা স্তর বার্তা নিম্নলিখিত মত দেখায় (সহজে স্ক্রল করার জন্য এখানে লাইন বিরতি যোগ করা হয়েছে):

Validation -- Validation Error:
  [ VUID-VkDeviceQueueCreateInfo-pQueuePriorities-parameter ]
Object 0: VK_NULL_HANDLE, type = VK_OBJECT_TYPE_DEVICE; | MessageID = 0xd6d720c6 |
vkCreateDevice: required parameter
  pCreateInfo->pQueueCreateInfos[0].pQueuePriorities specified as NULL.
The Vulkan spec states: pQueuePriorities must be a valid pointer to an array of
  queueCount float values
  (https://registry.khronos.org/vulkan/specs/1.3-extensions/html/vkspec.html
  #VUID-VkDeviceQueueCreateInfo-pQueuePriorities-parameter)

ডিবাগ কলব্যাক সক্ষম করুন

ডিবাগ ইউটিলস এক্সটেনশন VK_EXT_debug_utils আপনার অ্যাপ্লিকেশনটিকে একটি ডিবাগ মেসেঞ্জার তৈরি করতে দেয় যা একটি অ্যাপ্লিকেশন সরবরাহকৃত কলব্যাকে বৈধতা স্তরের বার্তা প্রেরণ করে। আপনার ডিভাইস এই এক্সটেনশনটি বাস্তবায়ন নাও করতে পারে, তবে এটি সাম্প্রতিকতম বৈধকরণ স্তরগুলিতে প্রয়োগ করা হয়েছে৷ VK_EXT_debug_report নামে একটি অবচয়িত এক্সটেনশনও রয়েছে, যা VK_EXT_debug_utils উপলব্ধ না হলে একই ধরনের ক্ষমতা প্রদান করে।

ডিবাগ ইউটিলস এক্সটেনশন ব্যবহার করার আগে, আপনাকে নিশ্চিত করতে হবে যে আপনার ডিভাইস বা একটি লোড করা বৈধতা স্তর এটি সমর্থন করে। নিচের উদাহরণটি দেখায় কিভাবে ডিবাগ ইউটিলস এক্সটেনশনটি সমর্থিত কিনা তা পরীক্ষা করতে হবে এবং এক্সটেনশনটি ডিভাইস বা বৈধতা স্তর দ্বারা সমর্থিত হলে একটি কলব্যাক নিবন্ধন করুন৷

// Get the instance extension count.
uint32_t inst_ext_count = 0;
vkEnumerateInstanceExtensionProperties(nullptr, &inst_ext_count, nullptr);

// Enumerate the instance extensions.
VkExtensionProperties inst_exts[inst_ext_count];
vkEnumerateInstanceExtensionProperties(nullptr, &inst_ext_count, inst_exts);

// Check for debug utils extension within the system driver or loader.
// Check if the debug utils extension is available (in the driver).
VkExtensionProperties *inst_exts_end = inst_exts + inst_ext_count;
bool debugUtilsExtAvailable = inst_exts_end !=
  std::find_if(inst_exts, inst_exts_end, [](VkExtensionProperties
    extensionProperties) {
    return strcmp(extensionProperties.extensionName,
      VK_EXT_DEBUG_UTILS_EXTENSION_NAME) == 0;
  });

if ( !debugUtilsExtAvailable ) {
  // Also check the layers for the debug utils extension.
  for (auto layer: layer_props) {
    uint32_t layer_ext_count;
    vkEnumerateInstanceExtensionProperties(layer.layerName, &layer_ext_count,
      nullptr);
    if (layer_ext_count == 0) continue;
    VkExtensionProperties layer_exts[layer_ext_count];
    vkEnumerateInstanceExtensionProperties(layer.layerName, &layer_ext_count,
    layer_exts);

    VkExtensionProperties * layer_exts_end = layer_exts + layer_ext_count;
    debugUtilsExtAvailable = layer_exts != std::find_if(
      layer_exts, layer_exts_end,[](VkExtensionProperties extensionProperties) {
        return strcmp(extensionProperties.extensionName,
        VK_EXT_DEBUG_UTILS_EXTENSION_NAME) == 0;
      });
    if (debugUtilsExtAvailable) {
        // Add the including layer into the layer request list if necessary.
        break;
    }
  }
}

if (!debugUtilsExtAvailable) return; // since this snippet depends on debugUtils

const char * enabled_inst_exts[] = { ..., VK_EXT_DEBUG_UTILS_EXTENSION_NAME };
uint32_t enabled_extension_count =
  sizeof(enabled_inst_exts)/sizeof(enabled_inst_exts[0]);

// Pass the instance extensions into vkCreateInstance.
VkInstanceCreateInfo instance_info = {};
instance_info.sType = VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO;
instance_info.enabledExtensionCount = enabled_extension_count;
instance_info.ppEnabledExtensionNames = enabled_inst_exts;

// NOTE: Can still return VK_ERROR_EXTENSION_NOT_PRESENT if validation layer
// isn't loaded.
vkCreateInstance(&instance_info, nullptr, &instance);

auto pfnCreateDebugUtilsMessengerEXT =
  (PFN_vkCreateDebugUtilsMessengerEXT)vkGetInstanceProcAddr(
    tutorialInstance, "vkCreateDebugUtilsMessengerEXT");
auto pfnDestroyDebugUtilsMessengerEXT =
  (PFN_vkDestroyDebugUtilsMessengerEXT)vkGetInstanceProcAddr(
    tutorialInstance, "vkDestroyDebugUtilsMessengerEXT");

// Create the debug messenger callback with your the settings you want.
VkDebugUtilsMessengerEXT debugUtilsMessenger;
if (pfnCreateDebugUtilsMessengerEXT) {
  VkDebugUtilsMessengerCreateInfoEXT messengerInfo;
  constexpr VkDebugUtilsMessageSeverityFlagsEXT kSeveritiesToLog =
    VK_DEBUG_UTILS_MESSAGE_SEVERITY_ERROR_BIT_EXT |
    VK_DEBUG_UTILS_MESSAGE_SEVERITY_WARNING_BIT_EXT;

constexpr VkDebugUtilsMessageTypeFlagsEXT kMessagesToLog =
  VK_DEBUG_UTILS_MESSAGE_TYPE_GENERAL_BIT_EXT |
  VK_DEBUG_UTILS_MESSAGE_TYPE_VALIDATION_BIT_EXT |
  VK_DEBUG_UTILS_MESSAGE_TYPE_PERFORMANCE_BIT_EXT;

  messengerInfo.sType           = VK_STRUCTURE_TYPE_DEBUG_UTILS_MESSENGER_CREATE_INFO_EXT;
  messengerInfo.pNext           = nullptr;
  messengerInfo.flags           = 0;
  messengerInfo.messageSeverity = kSeveritiesToLog;
  messengerInfo.messageType     = kMessagesToLog;

  // The DebugUtilsMessenger callback is explained in the following section.
  messengerInfo.pfnUserCallback = &DebugUtilsMessenger;
  messengerInfo.pUserData       = nullptr; // Custom user data passed to callback

  pfnCreateDebugUtilsMessengerEXT(instance, &messengerInfo, nullptr,
    &debugUtilsMessenger);
}

// Later, when shutting down Vulkan, call the following:
if (pfnDestroyDebugUtilsMessengerEXT) {
    pfnDestroyDebugUtilsMessengerEXT(instance, debugUtilsMessenger, nullptr);
}

আপনার অ্যাপ নিবন্ধন এবং কলব্যাক সক্ষম করার পরে, সিস্টেম এটিতে ডিবাগিং বার্তাগুলিকে রুট করে।

#include <android/log.h>

VKAPI_ATTR VkBool32 VKAPI_CALL DebugUtilsMessenger(
                        VkDebugUtilsMessageSeverityFlagBitsEXT messageSeverity,
                        VkDebugUtilsMessageTypeFlagsEXT messageTypes,
                        const VkDebugUtilsMessengerCallbackDataEXT *callbackData,
                        void *userData)
{
  const char validation[]  = "Validation";
  const char performance[] = "Performance";
  const char error[]       = "ERROR";
  const char warning[]     = "WARNING";
  const char unknownType[] = "UNKNOWN_TYPE";
  const char unknownSeverity[] = "UNKNOWN_SEVERITY";
  const char* typeString      = unknownType;
  const char* severityString  = unknownSeverity;
  const char* messageIdName   = callbackData->pMessageIdName;
  int32_t messageIdNumber     = callbackData->messageIdNumber;
  const char* message         = callbackData->pMessage;
  android_LogPriority priority = ANDROID_LOG_UNKNOWN;

  if (messageSeverity & VK_DEBUG_UTILS_MESSAGE_SEVERITY_ERROR_BIT_EXT) {
    severityString = error;
    priority = ANDROID_LOG_ERROR;
  }
  else if (messageSeverity & VK_DEBUG_UTILS_MESSAGE_SEVERITY_WARNING_BIT_EXT) {
    severityString = warning;
    priority = ANDROID_LOG_WARN;
  }
  if (messageTypes & VK_DEBUG_UTILS_MESSAGE_TYPE_VALIDATION_BIT_EXT) {
     typeString = validation;
  }
  else if (messageTypes & VK_DEBUG_UTILS_MESSAGE_TYPE_PERFORMANCE_BIT_EXT) {
     typeString = performance;
  }

  __android_log_print(priority,
                     "AppName",
                     "%s %s: [%s] Code %i : %s",
                     typeString,
                     severityString,
                     messageIdName,
                     messageIdNumber,
                     message);

  // Returning false tells the layer not to stop when the event occurs, so
  // they see the same behavior with and without validation layers enabled.
  return VK_FALSE;
}

বাহ্যিক বৈধতা স্তর ব্যবহার করুন

আপনাকে আপনার APK এ বৈধতা স্তর প্যাকেজ করতে হবে না; Android 9 (API স্তর 28) এবং উচ্চতর চলমান ডিভাইসগুলি আপনার বাইনারি থেকে বাহ্যিক বৈধতা স্তরগুলি ব্যবহার করতে পারে এবং সেগুলিকে গতিশীলভাবে বন্ধ এবং চালু করতে পারে৷ আপনার পরীক্ষার ডিভাইসে বৈধতা স্তরগুলি পুশ করতে এই বিভাগে পদক্ষেপগুলি অনুসরণ করুন:

বাহ্যিক বৈধতা স্তরগুলি ব্যবহার করতে আপনার অ্যাপ্লিকেশন সক্ষম করুন৷

অ্যান্ড্রয়েডের নিরাপত্তা মডেল এবং নীতি অন্যান্য প্ল্যাটফর্মের থেকে উল্লেখযোগ্যভাবে আলাদা। বাহ্যিক বৈধতা স্তর লোড করতে, নিম্নলিখিত শর্তগুলির মধ্যে একটি অবশ্যই সত্য হতে হবে:

  • লক্ষ্য অ্যাপটি ডিবাগযোগ্য । এই বিকল্পের ফলে আরও ডিবাগ তথ্য পাওয়া যায়, কিন্তু আপনার অ্যাপের কার্যক্ষমতাকে নেতিবাচকভাবে প্রভাবিত করতে পারে।

  • টার্গেট অ্যাপটি অপারেটিং সিস্টেমের ইউজারডিবাগ বিল্ডে চালানো হয় যা রুট অ্যাক্সেস মঞ্জুর করে।

  • শুধুমাত্র Android 11 (API লেভেল 30) বা উচ্চতর টার্গেট করা অ্যাপ: আপনার টার্গেট Android ম্যানিফেস্ট ফাইলে নিম্নলিখিত meta-data উপাদান রয়েছে:

    <meta-data android:name="com.android.graphics.injectLayers.enable"
      android:value="true"/>

একটি বাহ্যিক বৈধতা স্তর লোড করুন

Android 9 (API স্তর 28) এবং উচ্চতর চলমান ডিভাইসগুলি ভলকানকে আপনার অ্যাপের স্থানীয় স্টোরেজ থেকে বৈধতা স্তর লোড করার অনুমতি দেয়৷ Android 10 (API স্তর 29) থেকে শুরু করে, Vulkan একটি পৃথক APK থেকে বৈধতা স্তরটিও লোড করতে পারে। যতক্ষণ না আপনার অ্যান্ড্রয়েড সংস্করণ এটি সমর্থন করে ততক্ষণ আপনি যে কোনও পদ্ধতি বেছে নিতে পারেন।

আপনার ডিভাইসের স্থানীয় স্টোরেজ থেকে একটি বৈধতা স্তর বাইনারি লোড করুন

যেহেতু Vulkan আপনার ডিভাইসের অস্থায়ী ডেটা স্টোরেজ ডিরেক্টরিতে বাইনারি খোঁজে, আপনাকে প্রথমে Android Debug Bridge (adb) ব্যবহার করে বাইনারিটিকে সেই ডিরেক্টরিতে পুশ করতে হবে, নিম্নরূপ:

  1. ডিভাইসে আপনার অ্যাপের ডেটা স্টোরেজে লেয়ার বাইনারি লোড করতে adb push কমান্ডটি ব্যবহার করুন:

    $ adb push libVkLayer_khronos_validation.so /data/local/tmp
    
  2. আপনার অ্যাপ প্রক্রিয়ার মাধ্যমে স্তরটি লোড করতে adb shell এবং run-as কমান্ড ব্যবহার করুন। অর্থাৎ, রুট অ্যাক্সেসের প্রয়োজন ছাড়াই অ্যাপটিতে বাইনারিটির একই ডিভাইস অ্যাক্সেস রয়েছে।

    $ adb shell run-as com.example.myapp cp
      /data/local/tmp/libVkLayer_khronos_validation.so .
    $ adb shell run-as com.example.myapp ls libVkLayer_khronos_validation.so
    
  3. স্তরটি সক্ষম করুন

অন্য APK থেকে একটি বৈধতা স্তর বাইনারি লোড করুন

আপনি লেয়ার ধারণ করে এমন একটি APK ইন্সটল করতে adb ব্যবহার করতে পারেন এবং তারপর লেয়ারটি সক্রিয় করতে পারেন

adb install --abi abi path_to_apk

অ্যাপ্লিকেশনের বাইরে স্তরগুলি সক্ষম করুন৷

আপনি প্রতি-অ্যাপ বা বিশ্বব্যাপী ভলকান স্তরগুলি সক্ষম করতে পারেন। প্রতি-অ্যাপ সেটিংস রিবুট জুড়ে টিকে থাকে , যখন রিবুট করার সময় বিশ্বব্যাপী বৈশিষ্ট্যগুলি সাফ করা হয়।

প্রতি-অ্যাপ ভিত্তিতে স্তরগুলি সক্ষম করুন৷

নিম্নলিখিত পদক্ষেপগুলি প্রতি-অ্যাপ ভিত্তিতে স্তরগুলি কীভাবে সক্ষম করবেন তা বর্ণনা করে:

  1. স্তরগুলি সক্ষম করতে adb শেল সেটিংস ব্যবহার করুন:

    $ adb shell settings put global enable_gpu_debug_layers 1
    
  2. স্তরগুলি সক্ষম করতে লক্ষ্য অ্যাপ্লিকেশন নির্দিষ্ট করুন:

    $ adb shell settings put global gpu_debug_app <package_name>
    
  3. সক্রিয় করার জন্য স্তরগুলির তালিকা নির্দিষ্ট করুন (উপর থেকে নীচে), প্রতিটি স্তরকে একটি কোলন দ্বারা পৃথক করে:

    $ adb shell settings put global gpu_debug_layers <layer1:layer2:layerN>
    

    যেহেতু আমাদের একটি একক ক্রোনোস বৈধতা স্তর রয়েছে, তাই কমান্ডটি সম্ভবত এর মতো দেখাবে:

    $ adb shell settings put global gpu_debug_layers VK_LAYER_KHRONOS_validation
    
  4. এর ভিতরে স্তরগুলি অনুসন্ধান করতে এক বা একাধিক প্যাকেজ নির্দিষ্ট করুন:

    $ adb shell settings put global
      gpu_debug_layer_app <package1:package2:packageN>
    

আপনি নিম্নলিখিত কমান্ডগুলি ব্যবহার করে সেটিংস সক্ষম করা হয়েছে কিনা তা পরীক্ষা করতে পারেন:

$ adb shell settings list global | grep gpu
enable_gpu_debug_layers=1
gpu_debug_app=com.example.myapp
gpu_debug_layers=VK_LAYER_KHRONOS_validation

যেহেতু আপনি যে সেটিংস প্রয়োগ করেন তা ডিভাইস রিবুট জুড়ে অব্যাহত থাকে, আপনি স্তরগুলি লোড হওয়ার পরে সেটিংস সাফ করতে চাইতে পারেন:

$ adb shell settings delete global enable_gpu_debug_layers
$ adb shell settings delete global gpu_debug_app
$ adb shell settings delete global gpu_debug_layers
$ adb shell settings delete global gpu_debug_layer_app

বিশ্বব্যাপী স্তরগুলি সক্ষম করুন৷

পরবর্তী রিবুট না হওয়া পর্যন্ত আপনি বিশ্বব্যাপী এক বা একাধিক স্তর সক্ষম করতে পারেন। এটি নেটিভ এক্সিকিউটেবল সহ সমস্ত অ্যাপ্লিকেশনের জন্য স্তরগুলি লোড করার চেষ্টা করে।

$ adb shell setprop debug.vulkan.layers <layer1:layer2:layerN>