abuild(1) General Commands Manual abuild(1)

abuild - ساخت یک بسته apk از روی پرونده APKBUILD

abuild [گزینه‌ها] [-C DIR] [-P REPODEST] [-s SRCDEST] [-D DESCRIPTION] [cmd] ...

دستور abuild یک بسته باینری apk را بر اساس پرونده ورودی APKBUILD(5) به همراه سایر عملیات مرتبط می‌سازد.

-A

چاپ CARCH و خروج

-c

فعال‌سازی خروجی رنگی

-C DIR

تغییر پوشه به DIR پیش از اجرای هر دستور

-d

غیرفعال‌سازی بررسی وابستگی‌ها

-D DESCRIPTION

تنظیم توضیحات APKINDEX (پیش‌فرض: $repo $(git describe))

-f

اجبار در اجرای دستور مشخص‌شده (صرف‌نظر از بررسی به‌روز بودن apk یا معماری)

-F

اجرای اجباری در قالب ریشه (کاربر ارشد)

-h

نمایش این راهنما

-k

نگه‌داشتن بسته‌های ساخته‌شده حتی اگر APKBUILD یا سورس‌ها جدیدتر باشند

-K

نگه‌داشتن پوشه‌ها و پرونده‌های موقت زمان ساخت (srcdir/pkgdir/deps)

-m

غیرفعال‌سازی رنگ‌ها (تک‌رنگ)

-P REPODEST

تنظیم REPODEST به عنوان مسیر مخزن برای بسته‌های ایجادشده

-q

حالت بی‌صدا

-r

نصب وابستگی‌های مفقود از مخزن سیستم

-s SRCDEST

تنظیم پوشه مقصد بسته مبدا به SRCDEST

-v

نمایش پرجزئیات: نمایش هر دستور هنگام اجرا (خروجی بسیار پر سر و صدا)

all

اجرای کل فرآیند ساخت. این مقدار پیش‌فرض است در حالتی که دستور دیگری مشخص نشده باشد، و معادل اجرای validate builddeps clean fetch unpack prepare mkusers build check rootpkg است.

build

کامپایل و نصب بسته در $pkgdir.

check

اجرای آزمون‌های تعریف‌شده مربوط به بسته

checksum

تولید چکسام جهت گنجاندن در APKBUILD

clean

حذف پوشه‌های موقت ساخت و نصب

cleancache

حذف پرونده‌های بارگیری‌شده از $SRCDEST

cleanoldpkg

حذف بسته‌های باینری به جز نسخه فعلی

cleanpkg

حذف بسته باینری و سورس که قبلاً ساخته شده است

deps

نصب بسته‌های ذکرشده در makedepends و depends

fetch

دریافت سورس‌ها به $SRCDEST

index

تولید دوباره نمایه‌ها (indexها) در $REPODEST

listpkg

فهرست کردن بسته‌های هدف

package

نصب پروژه در پوشه پکیج

prepare

اعمال وصله‌ها (پچ‌ها)

rootbld

ساخت بسته در محیط چروت (chroot) تمیز. به abuild-rootbld نیاز دارد.

rootpkg

اجرای 'package'، توابع تفکیک، و ایجاد فایلهای apk در قالب fakeroot

validate

اعتبارسنجی اولیه پرونده APKBUILD

snapshot

ایجاد یک اسنپ‌شات از $giturl و بارگذاری آن در $disturl

sourcecheck

بررسی وجود بسته مبدا از راه دور در بالادست

srcpkg

ساخت بسته سورس

undeps

حذف نصب بسته‌های ذکرشده در makedepends و depends

unpack

استخراج سورس‌ها در $srcdir

up2date

مقایسه تاریخ‌های مقصد و سورس‌ها

APKBUILD

تغییر مسیر به پرونده APKBUILD.

BOOTSTRAP

استفاده هنگام راه‌اندازی اولیه بدون وجود بسته‌های قبلی از طریق به حداقل رساندن وابستگی‌های ساخت. این فلگ فقط بر تعداد کمی از بسته‌های خاص تأثیر دارد.

مقدار nocc از هرگونه کامپایل چشم‌پوشی می‌کند (برای نمونه: فقط شامل هدرهای سورس می‌شود). مقدار nolibc فرض می‌کند که هیچ libcای در دسترس نیست.

این فهرست مقادیر جامع نیست.

CHOST

تولید بسته‌ها برای معماری یا سه‌گانه داده‌شده.

CTARGET

تولید کامپایلر برای معماری یا سه‌گانه داده‌شده.

PACKAGER

نام و رایانامه بسته‌بندی‌کننده در قالب RFC5322. مانند: John Doe <john@example.com>.

PACKAGER_PRIVKEY

مسیر کلید خصوصی برای امضای بسته‌ها.

REPODEST

بسته‌ها در $REPODEST/$repo/$arch/$pkgname-$pkgver-r$pkgrel.apk ذخیره خواهند شد، که در آن $repo نام پایه پوشه والد $startdir است.

SOURCE_DATE_EPOCH

استفاده از این برچسب زمان به عنوان مرجع برای ساخت‌های بازتولیدپذیر (reproducible builds). ببینید: https://reproducible-builds.org/docs/source-date-epoch

SUDO_APK

دستور مورد استفاده برای اجرای apk با دسترسی ریشه. پیش‌فرض: abuild-apk.

USE_CCACHE

در صورت مقداردهی غیرخالی، پشتیبانی از ccache فعال می‌شود.

USE_COLORS

در صورت مقداردهی غیرخالی، خروجی رنگی با استفاده از توالی‌های گریز ANSI چاپ می‌شود.

/etc/abuild.conf

پیکربندی به‌طور پیش‌فرض از این پرونده خوانده می‌شود.

$HOME/.abuild/abuild.conf

پیکربندی ویژه‌ی کاربر در صورت وجود از این پرونده خوانده می‌شود.

به‌روزرسانی چکسام‌ها برای یک پرونده APKBUILD:

abuild checksum

ساخت یک پرونده APKBUILD و چاپ خروجی رنگی:

abuild -rc

مرجع مجوز SPDX (در وب: https://spdx.org/licenses)، newapkbuild(1), apk(8), APKBUILD(5), abuild.conf(5), buildrepo(1), ap(1), checkapk(1).

abuild: Natanael Copa <ncopa@alpinelinux.org>

مستندات:
Hugo Osvaldo Barrera <hugo@whynothugo.nl>

2026-06-05