الوظيفة

تتيح لك أداة jobb إنشاء ملفات توسيع APK مشفّرة وغير مشفّرة بتنسيق Opaque Binary Blob (OBB). يمكنك تنزيل ملفات التوسيع هذه وتثبيتها في تطبيقك باستخدام StorageManager على الأجهزة التي تعمل بنظام التشغيل Android 2.3 (مستوى واجهة برمجة التطبيقات 9) أو الإصدارات الأحدث. توفّر ملفات OBB مواد عرض ملفات إضافية لتطبيقات Android، مثل الرسومات والأصوات والفيديوهات، بشكل منفصل عن ملف APK للتطبيق. لمزيد من المعلومات حول استخدام ملفات توسيع، راجِع ملفات توسيع APK.

الاستخدام

في ما يلي بنية تشغيل jobb:

jobb [-d <directory>][-o <filename>][-pn <package>][-pv <version>] \
     [-k <key>][-ov][-dump <filename>][-v][-about]

يمكنك استخدام أداة jobb لإنشاء ملف OBB أو استخراج محتوى ملف OBB حالي. ينشئ الأمر المثال التالي ملف OBB من الملفات المصدر:

$ jobb -d /temp/assets/ -o my-app-assets.obb -k secret-key -pn com.my.app.package -pv 11

يوضّح هذا المثال كيفية تفريغ محتوى ملف OBB الحالي:

$ jobb -d /temp/obb-output/ -o my-app-assets.obb -k secret-key

الخيارات

يسرد الجدول أدناه خيارات سطر الأوامر لأداة jobb:

Option الوصف
-d <directory> يمكنك ضبط دليل الإدخال لإنشاء ملف OBB أو دليل الإخراج عند استخراج (-dump) ملف حالي. عند إنشاء ملف OBB، يتضمن `jobb` محتوى الدليل المحدّد وجميع أدلته الفرعية.
-o <filename> حدِّد اسم الملف لملف OBB. ويجب إدراج هذه المعلَمة عند إنشاء بيانات OBB والتخلّص من محتواها.
-pn <package> حدِّد اسم الحزمة للتطبيق الذي يحمِّل ملف OBB، والذي يتوافق مع قيمة package المحدّدة في بيان التطبيق. وهذه المعلَمة مطلوبة عند إنشاء ملف OBB.
-pv <version> اضبط أدنى إصدار للتطبيق الذي يمكنه تحميل ملف OBB، والذي يقابل قيمة android:versionCode في بيان التطبيق. وهذه المعلَمة مطلوبة عند إنشاء ملف OBB.
-k <key> حدِّد كلمة مرور لتشفير ملف OBB جديد أو فك تشفير ملف OBB حالي ومشفَّر.
-ov إنشاء ملف OBB يمثل تراكبًا لبنية ملف OBB الحالية. ويسمح هذا الخيار بتثبيت محتوى الحزمة الجديدة في الموقع نفسه كحزمة سابقة وإنشاء إصدارات رموز تصحيح لملفات OBB التي تم إنشاؤها سابقًا. وتستبدل الملفات المضمّنة في ملف تراكب OBB الملفات التي لها المسار نفسه.
-dump <filename>

استخرِج محتوى ملف OBB المحدّد. عند استخدام هذا الخيار، عليك أيضًا تحديد دليل إخراج المحتوى باستخدام المَعلمة -d <directory>.

ملاحظة: عند تفريغ ملف OBB حالي، يمكنك حذف المعلَمة -d <directory> للحصول على قائمة بالأدلة داخل الملف بدون استخراج المحتوى.

-v اضبط إخراج النتائج المطوَّلة للأداة.
-about عرض إصدار أداة jobb ومعلومات المساعدة الخاصة بها