.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "apk\-v3" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
apk-v3 \- فرمت بسته APK نسخه ۳ در پکیجمنیجر Alpine
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
یک فایل
\fB.\&apk\fR
نسخه ۳ شامل محتویات یک بسته واحد، مقداری متادیتا و چند امضا است.\& فایل
\fB.\&apk\fR
شامل درختی از اشیاء است که در یک قالب باینری سفارشی نمایش داده شده و در مجموع با یک طرح‌واره (schema) از پیش تعریف‌شده مطابقت دارد.\& این فرمت فایل در درون
\fBapk\fR(5)
تحت عنوان
.B "adb"
نامیده می‌شود.\&
.PP
.SH "قالب داده روی سیم (WIRE FORMAT)"
.PP
یک فایل apk نسخه ۳ از دنباله‌هایی از مقادیر سریال‌شده تشکیل شده است که هر یک از آن‌ها با یک کلمه ۳۲ بیتی
.B little\-endian
شروع می‌شود که همان برچسب (tag) مقدار است.\& ۴ بیت پرارزش برچسب، کد نوع داده (type code) هستند و ۲۸ بیت کم‌ارزش برای یک مقدار بی‌واسطه (immediate value) استفاده می‌شوند.\& کدهای نوع داده تعریف‌شده عبارتند از:
.PP
.TS
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l.
T{
0x0
T}	T{
Special
T}	T{
(direct)
T}
T{
0x1
T}	T{
Int
T}	T{
(direct)
T}
T{
0x2
T}	T{
Int32
T}	T{
(indirect)
T}
T{
0x3
T}	T{
Int64
T}	T{
(indirect)
T}
T{
0x8
T}	T{
Blob8
T}	T{
(indirect)
T}
T{
0x9
T}	T{
Blob16
T}	T{
(indirect)
T}
T{
0xa
T}	T{
Blob32
T}	T{
(indirect)
T}
T{
0xd
T}	T{
Array
T}	T{
(indirect)
T}
T{
0xe
T}	T{
Object
T}	T{
(indirect)
T}
.TE
.sp 1
یک مقدار مستقیم (direct) در ۲۸ بیت کم‌ارزش کلمه برچسب بسته‌بندی می‌شود؛ در مقابل، یک مقدار غیرمستقیم (indirect) در جای دیگری از فایل ذخیره شده و آفست (offset) آن مقدار غیرمستقیم در ۲۸ بیت کم‌ارزش کلمه برچسب قرار می‌گیرد.\&
.PP
آرایه‌ها و اشیاء با دنباله‌ای از اسلات‌های شماره‌گذاری‌شده نمایش داده می‌شوند؛ مقداری که درون کلمه برچسب آن‌ها بسته‌بندی می‌شود، آفستی است که این دنباله از آنجا شروع می‌شود.\& اولین اسلات همیشه تعداد کل اسلات‌ها است، بنابراین تمام آرایه‌ها و اشیاء حداقل حاوی یک مورد هستند.\&
.PP
تنها تفاوت واقعی میان آرایه‌ها و اشیاء در کدگذاری داده‌های سیم (wire encoding) این است که آرایه‌ها همگن (homogenous) هستند، در حالی که اشیاء ناهمگن (heterogeneous) بوده و برای هر اسلات یک نوع داده مشخص و مجزا دارند.\&
.PP
نوع ویژه (special) برای نمایش سه اتم استفاده می‌شود:
.PP
.TS
l l
l l
l l.
T{
0x0
T}	T{
NULL
T}
T{
0x1
T}	T{
TRUE
T}
T{
0x2
T}	T{
FALSE
T}
.TE
.sp 1
.SH "طرح‌واره‌های فایل (FILE SCHEMAS)"
.PP
طرح‌واره (schema) نمایشی از این است که چه عناصر داده‌ای در یک فایل adb انتظار می‌روند.\& طرح‌واره‌ها درختی را تشکیل می‌دهند که گره‌های آن یا طرح‌واره‌های اسکالر (که برگ‌های درخت هستند) می‌باشند یا طرح‌واره‌های آرایه/شیء که خود دارای فرزند هستند.\& برای نمونه، طرح‌واره برای یک شیء بسته (package object) ممکن است اعلام کند که حاوی فیلدهایی است که خود با طرح‌واره آرایه رشته‌ای (string array)، طرح‌واره pkginfo یا موارد مشابه مطابقت دارند.\&
.PP
خود طرح‌واره‌ها به هیچ عنوان در داخل فایل adb نمایش داده نمی‌شوند؛ آن‌ها در بخش‌هایی از
\fBapk\fR(1)
وجود دارند که چنین فایل‌هایی را خوانده و می‌نویسند.\& توضیح کامل تمام طرح‌واره‌های apk بسیار طولانی خواهد بود، اما به عنوان مثال، در اینجا طرح‌واره یک فایل منفرد درون یک بسته آورده شده است:
.PP
.TS
l l l
l l l
l l l
l l l
l l l
l l l.
T{
ADBI_FI_NAME
T}	T{
"name"
T}	T{
string
T}
T{
ADBI_FI_ACL
T}	T{
"acl"
T}	T{
acl
T}
T{
ADBI_FI_SIZE
T}	T{
"size"
T}	T{
int
T}
T{
ADBI_FI_MTIME
T}	T{
"mtime"
T}	T{
int
T}
T{
ADBI_FI_HASHES
T}	T{
"hash"
T}	T{
hexblob
T}
T{
ADBI_FI_TARGET
T}	T{
"target"
T}	T{
hexblob
T}
.TE
.sp 1
در اینجا، تمام فیلدها به جز
"acl"
اسکالر هستند، و خود acl یک طرح‌واره است که به این صورت می‌باشد:
.PP
.TS
l l l
l l l
l l l.
T{
ADBI_ACL_MODE
T}	T{
"mode"
T}	T{
oct
T}
T{
ADBI_ACL_USER
T}	T{
"user"
T}	T{
string
T}
T{
ADBI_ACL_GROUP
T}	T{
"group"
T}	T{
string
T}
.TE
.sp 1
.SH "بلوک‌ها (BLOCKS)"
.PP
یک فایل adb واقعی از دنباله‌ای از بلوک‌های نوع‌دار (typed blocks) تشکیل شده است؛ هر بلوک نیز با یک کلمه برچسب ۳۲ بیتی
.B little\-endian
آغاز می‌شود که دارای ۲ بیت نوع و ۳۰ بیت اندازه است.\& دو بیت نوع عبارتند از:
.PP
.TS
l l
l l
l l
l l.
T{
0x0
T}	T{
ADB
T}
T{
0x1
T}	T{
SIG
T}
T{
0x2
T}	T{
DATA
T}
T{
0x3
T}	T{
DATAX
T}
.TE
.sp 1
فایل adb باید با یک بلوک
.B ADB
آغاز شود، سپس به صورت اختیاری یک یا چند بلوک
.B SIG
و در ادامه یک یا چند بلوک
.B DATA
قرار گیرد.\& بلوک
.B ADB
باید با یک عدد جادویی (magic number) شروع شود که نشان‌دهنده طرح‌واره شیء ریشه کل بلوک
.B ADB
است.\& همچنین بلوک
.B ADB
در خارج از شیء ریشه، حاوی مقداری متادیتا است که نسخه فرمت adb مورد استفاده را توصیف می‌کند.\&
.PP
بلوک
.B SIG
حاوی یک یا چند امضا از بلوک
.B ADB
است.\& امضاهای متعلق به یک نسخه مشابه باید در همان بلوک
.B SIG
قرار گیرند.\& اگر در آینده نسخه جدیدی از امضا مشخص شود، و بسته بنا به دلایل سازگاری در دوره گذار نیاز به داشتن دو نسخه متفاوت از امضا داشته باشد، آنگاه باید دو بلوک امضا وجود داشته باشد، یکی برای هر نسخه.\&
.PP
برخلاف فرمت نسخه ۲، نام کلید استفاده‌شده برای امضا به طور صریح مشخص نمی‌شود.\& در عوض از شناسه ذاتی (intrinsic ID) کلید برای جستجو استفاده می‌شود، بنابراین اعتبارسنج‌ها باید کلید را بر اساس شناسه کلید پیدا کنند.\& همچنین برخلاف فرمت نسخه ۲، بلوک
.B ADB
به طور مستقیم امضا نمی‌شود، بلکه ابتدا توسط یک خلاصه‌ساز امن (در حال حاضر
.BR SHA512 )
هش می‌شود.\& پس از این، یک محموله (payload) کوچک حاوی این هش از پیش محاسبه‌شده توسط الگوریتم مشخص‌شده امضا می‌شود (معمولاً این محموله سپس در طول فرآیند امضا دوباره با یک دایجست امن بر اساس الگوریتم امضا هش می‌شود).\&
.PP
بلوک‌های
.B DATA
تنها برای ذخیره داده‌های فایل بسته استفاده می‌شوند؛ تمام متادیتای فایل، از جمله هش‌های محتوا، در عوض در بلوک
.B ADB
ذخیره می‌شوند.\& بنابراین محتویات بلوک‌های
.B DATA
توسط هش‌های ارائه‌شده در بلوک
.B ADB
محافظت می‌شوند، که خود آن نیز توسط امضا در بلوک
.B SIG
محافظت می‌شود.\&
.PP
در حال حاضر ظاهر شدن یک بلوک
.B DATAX
غیرمجاز است.\&
.PP
.SH "نکات (NOTES)"
.PP
فرمت فایل نسخه ۳ با چیدمان ساختارهای زبان C در حافظه (C struct layout) درهم‌تنیده است، زیرا گاهی اوقات مستقیماً استراکت‌ها را در بخش adb می‌نویسد، از جمله هرگونه فاصله‌گذاری (padding) اضافه‌شده توسط کامپایلر و مواردی از این دست.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBabuild\fR(1), \fBapk\fR(8), \fBapk\-package\fR(5), \fBapk\-v2\fR(5)