شروع کار#
این راهنما برای زمانی است که میخواهید 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.shWindows
./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 |
-os | OS هدف: linux، windows، macos، android یا all |
-project-dir | مسیر پروژه برای setup-dev |
-verbose | نمایش مرحلهبهمرحلهٔ کارها |
-version | تگ Release برای install و update؛ در release نسخهٔ داخل باینری |
-xray-version | نسخهٔ Xray؛ پیشفرض v26.3.27 |