Update Persian documents (#520)

* Build-macOs-fa added

* persian documents fixed

* Build_Core_fa.md added
This commit is contained in:
AbolfazlHo 2023-04-23 11:48:13 +05:30 committed by GitHub
parent a2d7a0e28d
commit 435f89affa
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 174 additions and 33 deletions

View File

@ -62,7 +62,7 @@ https://matsuridayo.github.io
[Windows](docs/Build_Windows.md)
[macOs] (docs/Build_MacOS_fa)
[macOs](docs/Build_MacOS_fa.md)
## کمک مالی / Donate

83
docs/Build_Core_fa.md Normal file
View File

@ -0,0 +1,83 @@
## ساختن (بیلد) nekobox_core و nekoray_core
###ساختن (بیلد) آسان
۱. در Terminal به روت پروژه Nekoray در دستگاه خود بروید.
اگر تا اینجا با مستندات پیش آمده باشید، کافی است دستور زیر را در Terminal وارد کنید و دکمه Return را بفشارید.
```shell
cd .
```
<br>
۲. در همین مسیر`v2ray-core` را از [این](https://github.com/MatsuriDayo/v2ray-core) منبع دریافت کنید.
برای این می توانید دستور زیر را در `Terminal` وارد کنید و دکمه `Return` را بفشارید.
```shell
git clone https://github.com/MatsuriDayo/v2ray-core.git
```
<br>
۳. دستورهای زیر را به ترتیب در `Terminal` وارد کنید و دکمه `Return` را بفشارید.
```shell
cd go/cmd/nekoray_core
go build
```
اگر پس از دستور دوم با خطای `zsh: command not found: go` رو به رو شدید به این معنی است که `go` روی دستگاه شما نصب نیست. برای نصب `go` دستور زیر را در `Terminal` وارد کنید و دکمه `Return` را بفشارید.
```shell
brew install go
```
پس از نصب شدن `go` باز دستور `go build` را در `Terminal` اجرا کنید.
در پایان این گام، فایل `nekoray_core` در مسیر زیر ساخته خواهد شد.
`مسیر پروژه Nekoray/go/cmd/nekoray_core`
<br>
۴. دستورهای زیر را به ترتیب در `Terminal` وارد کنید و دکمه `Return` را بفشارید.
```shell
cd ..
cd nekobox_core
go build
```
در پایان این گام، فایل `nekobox_core` در مسیر زیر ساخته خواهد شد.
<br>
- برای موارد خاص به`libs/get_source.sh`و `libs/build_go.sh` رجوع کنید.
- نیازی نیست این مراحل را برای پوشه `updater` انجام دهید. این سخن به این معنی است که نیازی نیست `launcher` را بسازید (بیلد بگیرید).
<br>
### ساختن (بیلد) معمولی
۱. در Terminal به روت پروژه Nekoray در دستگاه خود بروید.
اگر تا اینجا با مستندات پیش آمده باشید، کافی است دستور زیر را در Terminal وارد کنید و دکمه Return را بفشارید.
```shell
cd .
```
<br>
۲. در همین مسیر`v2ray-core` را از [این](https://github.com/MatsuriDayo/v2ray-core) منبع دریافت کنید.
برای این می توانید دستور زیر را در `Terminal` وارد کنید و دکمه `Return` را بفشارید.
```shell
git clone https://github.com/MatsuriDayo/v2ray-core.git
```
<br>
۳. دستور زیر را در `Terminal`وارد کنید و دکمه `Return`را بفشارید.
```shell
GOOS=windows GOARCH=amd64 bash libs/build_go.sh
```
- برای دریافتن `GOOS` و `GOARCH` پشتیبانی شده به `libs/build_go.sh`مراجعه کنید.
<br>
### تگ های sing-box
بوای تگ های خاص به `libs/build_go.sh` رجوع کنید.

View File

@ -1,80 +1,125 @@
# کامپایل کردن Nekoray در macOs
## پروژه Nekoray را از منبع آن دریافت کنید
در terminal در مسیر دلخواه خود، دستور زیر را وارد کنید و دکمه return را بفشارید.
در `Terminal` در مسیر دلخواه خود، دستور زیر را وارد کنید و دکمه `return` را بفشارید.
```shell
git clone https://github.com/MatsuriDayo/nekoray.git --recursive
```
اگر `git` روی دستگاه از پیش نصب نباشد، دستگاه، خودکار نصب آن را پیشنهاد می‌کند. مرحله‌های نصب را به انجام برسانید و سپس دوباره دستور پیش گفته را در `Terminal` اجرا کنید.
سپس وارد پوشه `nekoray` شوید.
برای کامپایل کردن پروژه، پیش‌نیازهای زیر را نصب کنید. برای این، دستور زیر را در `Terminal` وارد کنید و دکمه `Return` را بفشارید.
```shell
cd nekoray
```
<br>
## پیش‌نیازها
برای کامپایل کردن پروژه، پیش‌نیازهای زیر را نصب کنید.
۱. `CMake`
برای نصب CMake دستور زیر را در terminal وارد کنید و دکمه return را بفشارید.
###۱. `CMake`
برای نصب `CMake` دستور زیر را در `terminal` وارد کنید و دکمه `return` را بفشارید.
```shell
brew install cmake
```
اگر با خطای `zsh: command not found: brew` روبه‌رو شدید به این معنی است که `homebrew` در دستگاه شما نصب نیست. برای نصب آن نخست باید XCode's command line tools را نصب کنید. اگر به این مشکل برخورده‌اید، گام‌های ۱.۱، ۱.۲ و ۱.۳ را دنبال کنید.
۱.۱. نصب XCode's command line tools
دستور زیر را در terminal وادر کنید و دکمه return را بفشارید.
اگر با خطای `zsh: command not found: brew` روبه‌رو شدید به این معنی است که `homebrew` در دستگاه شما نصب نیست. برای نصب آن نخست باید `XCode's command line tools` را نصب کنید. اگر به این مشکل برخورده‌ اید، گام های `۱.۱`، `۱.۲` و `۱.۳` را دنبال کنید.
<br>
####۱.۱. نصب `XCode's command line tools`
دستور زیر را در `terminal` وادر کنید و دکمه `return` را بفشارید.
```shell
xcode-select --install
```
۱.۲. نصب homebrew
دستور زیر را در terminal وارد کنید و دکمه return را بفشارید.
<br>
####۱.۲. نصب `homebrew`
دستور زیر را در `terminal` وارد کنید و دکمه `return` را بفشارید.
```shell
curl -fsSL -o install.sh https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh
```
۱.۳. حال می‌توانید با دستوری که پیشتر گفتیم، CMake را نصب کنید.
۲. `Ninja`
برای نصب Ninja دستور زیر را در terminal وارد کنید و دکمه return را بفشارید.
<br>
####۱.۳. حال می‌توانید با دستوری که پیشتر گفتیم، `CMake` را نصب کنید.
<br>
###۲. `Ninja`
برای نصب `Ninja` دستور زیر را در `terminal` وارد کنید و دکمه `return` را بفشارید.
```shell
sudo port install ninja
```
اگر با خطای `sudo: port: command not found` روبه‌رو شدید، به این معنی است که MacPorts روی دستگاه شما نصب نیست. نسخه MacPorts متناسب با نسخه macOs خود را بارگری و نصب کنید. سپس بار دیگر، دستور نصب Ninja را در terminal وارد کرده و دکمه return را بفشارید.
اگر با خطای `sudo: port: command not found` روبه‌رو شدید، به این معنی است که `MacPorts` روی دستگاه شما نصب نیست. نسخه `MacPorts` متناسب با نسخه `macOs` خود را بارگری و نصب کنید. سپس بار دیگر، دستور نصب `Ninja` را در `terminal` وارد کرده و دکمه `return` را بفشارید.
۳. `npm`
بدای نصب npm دستور زیر را در terminal وارد کنید و دکمه return را بفشارید.
<br>
###۳. `npm`
برای نصب `npm` دستور زیر را در `terminal` وارد کنید و دکمه `return` را بفشارید.
```shell
brew install node
brew install npm
```
۴. `qtbase`
برای نصب qtbase دستور زیر را در terminal وارد کنید و دکمه return را بفشارید.
<br>
###۴. `qtbase`
برای نصب `qtbase` دستور زیر را در `terminal` وارد کنید و دکمه `return` را بفشارید.
```shell
sudo port install qt5-qtbase
```
۵. `qtsvg`
برای نصب qtsvg دستور زیر را در terminal وارد کنید و دکمه return را بفشارید.
<br>
###۵. `qtsvg`
برای نصب `qtsvg` دستور زیر را در `terminal` وارد کنید و دکمه `return` را بفشارید.
```shell
sudo port install qt5-qtsvg
```
۶. `qttools`
برای نصب qttools دستور زیر را در terminal وارد کنید و دکمه return را بفشارید.
<br>
###۶. `qttools`
برای نصب `qttools` دستور زیر را در `terminal` وارد کنید و دکمه `return` را بفشارید.
```shell
sudo port install qt5-qttools
```
۷. `appdmg`
برای نصب appdmg دستور زیر را در terminal وارد کنید و دکمه return را بفشارید.
<br>
###۷. `appdmg`
برای نصب `appdmg` دستور زیر را در `terminal` وارد کنید و دکمه `return` را بفشارید.
```shell
sudo npm install -g appdmg
```
<br>
## C++
### وابستگی‌های C و ++C را کامپایل و نصب کنید.
دستور زیر را در terminal وارد کرده و دکمه return را بفشارید.
دستور زیر را در `terminal` وارد کرده و دکمه `return` را بفشارید.
```shell
./libs/build_deps_all.sh
```
<br>
### آنتولوژی را کامپایل کنید.
دستور زیر را در terminal وارد کرده و دکمه return را بفشارید.
دستور زیر را در `terminal` وارد کرده و دکمه `return` را بفشارید.
```shell
mkdir build
cd build
@ -82,16 +127,26 @@ cmake -GNinja -DCMAKE_BUILD_TYPE=Release -DNKR_PACKAGE_MACOS=1 ..
ninja
```
### هسته نرم‌افزار را کامپایل کنید.
چگونگی کامپایل کردن هسته نرم‌افزار را [اینجا ](./Build_Core.md)بخوانید.
<br>
## هسته نرم افزار
### هسته نرم افزار را کامپایل کنید.
چگونگی کامپایل کردن هسته نرم افزار را [اینجا ](./Build_Core_fa.md)بخوانید.
<br>
### جایگذاری هسته
فایل کامپایل شده `nekoray_core` و `nekobox_core` را در مسیر زیر کپی کنید.
`build/nekoray.app/Contents/MacOS`
<br>
### فایل‌های جغرافی را تهیه کنید. (اختیاری)
اگر مایلید با اجرای دستورهای زیر در terminal فایل‌های جغدافی را تهیه کنید.
## فایل‌های جغرافی را تهیه کنید. (اختیاری)
اگر مایلید، با اجرای دستورهای زیر در `Terminal` فایل های جغرافی را تهیه کنید.
```shell
curl -Lso build/nekoray.app/Contents/MacOS/geoip.dat "https://github.com/Loyalsoldier/v2ray-rules-dat/releases/latest/download/geoip.dat"
@ -99,7 +154,10 @@ curl -Lso build/nekoray.app/Contents/MacOS/geosite.dat "https://github.com/v2fly
curl -Lso build/nekoray.app/Contents/MacOS/geoip.db "https://github.com/SagerNet/sing-geoip/releases/latest/download/geoip.db"
curl -Lso build/nekoray.app/Contents/MacOS/geosite.db "https://github.com/SagerNet/sing-geosite/releases/latest/download/geosite.db"
```
<br>
## پایان کار
فایل اجرایی `Nekoray` در مسیر زیر قرار دارد. می‌توانید آن را در مسیر دلخواه کپی کنید.
### پایان کار
فایل اجرایی Nekoray در مسیر زیر قرار دارد. می‌توانید آن را در مسیر دلخواه کپی کنید.
`مسیر پروژه Nekoray/build`