Docs GitHub
-- --
Theme:
Language:
EN فا

شروع کار#

این راهنما برای زمانی است که می‌خواهید bgscan را روی سیستم خودتان اجرا و تغییر دهید.

قبل از شروع، راهنمای مشارکت را ببینید. آن‌جا گفته‌ایم Branchها و PRها را چطور نگه می‌داریم.

چیزهایی که لازم دارید#

  • Go نسخهٔ 1.27 یا جدیدتر
  • Git
  • اگر برای Android Build می‌گیرید: Android NDK

سورس را بگیرید#

git clone https://github.com/MohsenBg/bgscan.git
cd bgscan

برای تغییر خودتان یک Branch بسازید:

git checkout -b feature/my-change

وابستگی‌ها را آماده کنید#

bgscan برای گرفتن وابستگی‌های مخصوص هر سیستم، از bgscan-builder استفاده می‌کند.

Linux / macOS

./scripts/install-deps.sh

Windows

./scripts/install-deps.ps1

این اسکریپت bgscan-builder را به ریشهٔ پروژه می‌آورد و با setup-dev وابستگی مناسب OS و معماری فعلی را دانلود می‌کند.

اجرا#

go mod tidy
go run ./cmd/bgscan/

برنامه اول بررسی‌های اولیه را داخل TUI نشان می‌دهد. اگر همه‌چیز درست بود، Enter بزنید.

ساخت Release#

اگر هنوز bgscan-builder را ندارید، آن را نصب کنید:

# Linux / macOS
./scripts/install-builder.sh

# Windows
./scripts/install-builder.ps1

بعد Release بسازید:

bgscan-builder release -os linux -arch amd64
bgscan-builder release -os android -arch arm64 -ndk-dir /opt/android-ndk
bgscan-builder release -os all -arch all -dest ./dist

برای Android باید مسیر NDK را با -ndk-dir بدهید.

Flagکار
-archمعماری هدف: amd64، arm64، arm32، amd32 یا all
-destپوشهٔ خروجی؛ پیش‌فرض ./dist
-dirپوشهٔ نصب bgscan برای install و update؛ پیش‌فرض bgscan
-ndk-dirمسیر Android NDK
-osOS هدف: linux، windows، macos، android یا all
-project-dirمسیر پروژه برای setup-dev
-verboseنمایش مرحله‌به‌مرحلهٔ کارها
-versionتگ Release برای install و update؛ در release نسخهٔ داخل باینری
-xray-versionنسخهٔ Xray؛ پیش‌فرض v26.3.27