.\" 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\-mkndx" "8" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
apk-mkndx \- ایجاد پرونده نمایه مخزن apkv3 از بسته‌ها
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBapk mkndx\fR [<\fIگزینه‌ها\fR>.\&.\&.\&] \fIبسته‌ها\fR.\&.\&.\&
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBapk mkndx\fR یک نمایه مخزن از فهرستی از پرونده‌های بسته ایجاد می‌کند.\& برای اطلاعات بیشتر در مورد نمایه‌های مخزن، \fBapk\-repositories\fR(5) را ببینید.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-description\fR, \fB\-d\fR \fITEXT\fR
.RS 4
افزودن توضیحات به نمایه.\& در بالادست، از این گزینه برای افزودن اطلاعات نسخه بر اساس SHA کامیت git در aports HEAD هنگام تولید نمایه استفاده می‌شود.\&
.PP
.RE
\fB\-\-filter\-spec\fR \fIPKGNAME_SPEC\fR
.RS 4
فقط نمایه قبلی را فیلتر می‌کند.\& هر آرگومان باید نام بسته با قالب \fIPKGNAME_SPEC\fR باشد تا از نمایه گنجانده شود.\& از این گزینه می‌توان برای ایجاد یک زیرمجموعه از نمایه موجود استفاده کرد.\&
.PP
.RE
\fB\-\-hash\fR \fIHASH\fR
.RS 4
استفاده از \fIHASH\fR به عنوان الگوریتم یکپارچگی apk v3.\& در حال حاضر موارد زیر پشتیبانی می‌شوند:
.PD 0
.IP \(bu 4
sha256 (پیش‌فرض)
.IP \(bu 4
sha256\-160
.PD
.PP
گزینه \fBsha256\-160\fR برای تولید نمایه‌ای سازگار با پیش‌انتشارهای قدیمی apkv3 مجاز است که هش‌های طولانی‌تر را به درستی پردازش نمی‌کنند.\&
.PP
.RE
\fB\-\-index\fR, \fB\-x\fR \fIINDEX\fR
.RS 4
خواندن یک نمایه موجود از \fIINDEX\fR جهت افزایش سرعت ایجاد نمایه جدید از طریق استفاده مجدد از داده‌ها در صورت امکان.\&
.PP
.RE
\fB\-\-output\fR, \fB\-o\fR \fIFILE\fR
.RS 4
ارسال نمایه تولیدشده به \fIFILE\fR.\&
.PP
.RE
\fB\-\-pkgname\-spec\fR \fIPKGNAME_SPEC\fR
.RS 4
مشخص کردن مشخصات نام بسته برای بارگیری بسته‌ها.\& برنامه APK آدرس دانلود (URL) را نسبت به پرونده نمایه با بسط این مشخصات با مقادیر ویژه هر بسته ایجاد می‌کند.\&
.PP
اگر مشخصات شامل :// باشد، یک URL مطلق در نظر گرفته می‌شود و نه نسبی.\& استفاده از مشخصات نام بسته مطلق برای مخازن عمومی توصیه نمی‌شود زیرا مانع از ایجاد آینه‌ها (mirroring) می‌شود.\& با این حال، این ویژگی در محیط ساخت برای ایجاد یک زیرمجموعه از یک نمایه و ارجاع آن به بسته‌های موجود در مخزن دیگر مفید است.\&
.PP
در صورت عدم تعیین، مقدار پیش‌فرض توسط \fBapk\fR در زمان اجرا بر اساس نحوه ارجاع به مخزن تعیین می‌شود:
.PD 0
.IP \(bu 4
${arch}/${name}\-${version}.\&apk اگر بر اساس URL مسیر پایه مخزن ارجاع داده شود
.IP \(bu 4
${name}\-${version}.\&apk اگر بر اساس URL پرونده نمایه مخزن ارجاع داده شود
.PD
.PP
متغیرهای جایگزینی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.PD 0
.IP \(bu 4
name
.IP \(bu 4
version
.IP \(bu 4
arch
.IP \(bu 4
hash
.PD
.PP
علاوه بر این، می‌توان از یک پیشوند متغیر با نحو \fB${name:4}\fR استفاده کرد.\& این کار جایگزینی را به حداکثر ۴ نویسه کوتاه می‌کند.\&
.PP
نویسنده مشخصات باید اطمینان حاصل کند که مخزن شامل چندین بسته که به یک نام پرونده بسته یکسان بسط می‌یابند، نباشد.\&
.RE