ساخت از منبع در ویندوز، ساخت از منبع در ویندوز

یک بسته Pip TensorFlow از منبع بسازید و آن را روی ویندوز نصب کنید.

راه اندازی برای ویندوز

ابزارهای ساخت زیر را برای پیکربندی محیط توسعه ویندوز خود نصب کنید.

وابستگی های بسته Python و TensorFlow را نصب کنید

یک نسخه Python 3.9+ 64 بیتی را برای ویندوز نصب کنید. pip را به عنوان یک ویژگی اختیاری انتخاب کنید و آن را به متغیر محیطی %PATH% خود اضافه کنید.

وابستگی های بسته Pip TensorFlow را نصب کنید:

pip3 install -U pip
pip3 install -U six numpy wheel packaging
pip3 install -U keras_preprocessing --no-deps

وابستگی ها در فایل setup.py در REQUIRED_PACKAGES فهرست شده اند.

Bazel را نصب کنید

Bazel، ابزار ساخت مورد استفاده برای کامپایل TensorFlow را نصب کنید . برای نسخه Bazel، تنظیمات ساخت تست شده برای ویندوز را ببینید. Bazel را برای ساخت ++C پیکربندی کنید.

مکان فایل اجرایی Bazel را به متغیر محیطی %PATH% خود اضافه کنید.

MSYS2 را نصب کنید

MSYS2 را برای ابزارهای bin مورد نیاز برای ساخت TensorFlow نصب کنید . اگر MSYS2 در C:\msys64 نصب شده است، C:\msys64\usr\bin را به متغیر محیطی %PATH% خود اضافه کنید. سپس با استفاده از cmd.exe اجرا کنید:

pacman -Syu (requires a console restart)
pacman -S git patch unzip
pacman -S git patch unzip rsync

Visual C++ Build Tools 2022 را نصب کنید

ابزار ساخت Visual C++ 2022 را نصب کنید. این با Visual Studio Community 2022 ارائه می شود اما می توان آن را به طور جداگانه نصب کرد:

1. به دانلودهای ویژوال استودیو بروید،
2. ابزارهای ویژوال استودیو یا ابزارهای دیگر، چارچوب و قابل توزیع مجدد را انتخاب کنید،
3. دانلود و نصب کنید:
   • ابزارهای ساخت ویژوال استودیو 2022
   • Microsoft Visual C++ Redistributables برای Visual Studio 2022

LLVM را نصب کنید

1. به دانلودهای LLVM بروید،
2. دانلود و نصب LLVM سازگار با ویندوز در C:/Program Files/LLVM به عنوان مثال، LLVM-17.0.6-win64.exe

نصب پشتیبانی از GPU (اختیاری)

برای نصب درایورها و نرم افزارهای اضافی مورد نیاز برای اجرای TensorFlow بر روی یک GPU، به راهنمای پشتیبانی از GPU ویندوز مراجعه کنید.

کد منبع TensorFlow را دانلود کنید

از Git برای کلون کردن مخزن TensorFlow استفاده کنید ( git با MSYS2 نصب شده است):

git clone https://github.com/tensorflow/tensorflow.git
cd tensorflow

مخزن به طور پیش فرض به شاخه توسعه master است. همچنین می توانید یک شاخه انتشار را برای ساخت بررسی کنید:

git checkout branch_name  # r1.9, r1.10, etc.

اختیاری: تنظیم متغیر محیطی

قبل از اجرای دستور build دستورات زیر را اجرا کنید تا با ایجاد پکیج دچار مشکل نشوید: (اگر دستورات زیر هنگام نصب بسته ها تنظیم شده اند، لطفاً آنها را نادیده بگیرید). برای بررسی اینکه آیا همه مسیرها به درستی تنظیم شده اند، set را اجرا کنید، echo %Environmental Variable% را اجرا کنید، به عنوان مثال، echo %BAZEL_VC% برای بررسی مسیر تنظیم شده برای یک متغیر محیطی خاص اجرا کنید.

راه‌اندازی مسیر پایتون مسئله tensorflow:issue#59943 ، tensorflow:issue#9436 ، tensorflow:issue#60083

set PATH=path/to/python;%PATH% # [e.g. (C:/Python311)]
set PATH=path/to/python/Scripts;%PATH% # [e.g. (C:/Python311/Scripts)] 
set PYTHON_BIN_PATH=path/to/python_virtualenv/Scripts/python.exe 
set PYTHON_LIB_PATH=path/to/python virtualenv/lib/site-packages 
set PYTHON_DIRECTORY=path/to/python_virtualenv/Scripts 

مسیر Bazel/MSVC/CLANG راه اندازی مشکل tensorflow:issue#54578

set BAZEL_SH=C:/msys64/usr/bin/bash.exe 
set BAZEL_VS=C:/Program Files/Microsoft Visual Studio/2022/BuildTools 
set BAZEL_VC=C:/Program Files/Microsoft Visual Studio/2022/BuildTools/VC 
set Bazel_LLVM=C:/Program Files/LLVM (explicitly tell Bazel where LLVM is installed by BAZEL_LLVM, needed while using CLANG)
set PATH=C:/Program Files/LLVM/bin;%PATH% (Optional, needed while using CLANG as Compiler)

اختیاری: پیکربندی ساخت

بیلدهای TensorFlow توسط فایل .bazelrc در دایرکتوری ریشه مخزن پیکربندی می شوند. از اسکریپت های ./configure یا ./configure.py می توان برای تنظیم تنظیمات رایج استفاده کرد.

اگر نیاز به تغییر پیکربندی دارید، اسکریپت ./configure را از دایرکتوری ریشه مخزن اجرا کنید.

python ./configure.py

این اسکریپت مکان وابستگی های TensorFlow را از شما می خواهد و گزینه های پیکربندی ساخت اضافی را می خواهد (برای مثال پرچم های کامپایلر). در زیر نمونه ای از اجرای python ./configure.py نشان داده شده است (ممکن است جلسه شما متفاوت باشد):

python ./configure.py
You have bazel 6.5.0 installed.
Please specify the location of python. [Default is C:\Python311\python.exe]:

Found possible Python library paths:
C:\Python311\lib\site-packages
Please input the desired Python library path to use.  Default is [C:\Python311\lib\site-packages]

Do you wish to build TensorFlow with ROCm support? [y/N]:
No ROCm support will be enabled for TensorFlow.

Warning: Cannot build with CUDA support on Windows.
Starting in TF 2.11, CUDA build is not supported for Windows. To use TensorFlow GPU on Windows, you will need to build/install TensorFlow in WSL2.

Do you want to use Clang to build TensorFlow? [Y/n]:
Add "--config=win_clang" to compile TensorFlow with CLANG.

Please specify the path to clang executable. [Default is C:\Program Files\LLVM\bin\clang.EXE]:

You have Clang 17.0.6 installed.

Please specify optimization flags to use during compilation when bazel option "--config=opt" is specified [Default is /arch:AVX]:

Would you like to override eigen strong inline for some C++ compilation to reduce the compilation time? [Y/n]:
Eigen strong inline overridden.

Would you like to interactively configure ./WORKSPACE for Android builds? [y/N]:
Not configuring the WORKSPACE for Android builds.

Preconfigured Bazel build configs. You can use any of the below by adding "--config=<>" to your build command. See .bazelrc for more details.
        --config=mkl            # Build with MKL support.
        --config=mkl_aarch64    # Build with oneDNN and Compute Library for the Arm Architecture (ACL).
        --config=monolithic     # Config for mostly static monolithic build.
        --config=numa           # Build with NUMA support.
        --config=dynamic_kernels        # (Experimental) Build kernels into separate shared objects.
        --config=v1             # Build with TensorFlow 1 API instead of TF 2 API.
Preconfigured Bazel build configs to DISABLE default on features:
        --config=nogcp          # Disable GCP support.
        --config=nonccl         # Disable NVIDIA NCCL support.

پکیج پیپ را بسازید و نصب کنید

پکیج پیپ در دو مرحله ساخته شده است. یک دستور bazel build یک برنامه "package-builder" ایجاد می کند. سپس Package-builder را برای ایجاد بسته اجرا می کنید.

پکیج ساز را بسازید

tensorflow:master repo به‌طور پیش‌فرض برای ساخت 2.x به‌روزرسانی شده است. Bazel را نصب کنید و bazel build برای ایجاد بسته‌ساز TensorFlow استفاده کنید.

bazel build //tensorflow/tools/pip_package:wheel

فقط CPU

bazel برای ساختن بسته سازنده TensorFlow با پشتیبانی فقط از CPU استفاده کنید:

ساخت با MSVC

bazel build --config=opt --repo_env=TF_PYTHON_VERSION=3.11 //tensorflow/tools/pip_package:wheel --repo_env=WHEEL_NAME=tensorflow_cpu

ساخت با CLANG

از --config= win_clang برای ساخت TenorFlow با کامپایلر CLANG استفاده کنید:

bazel build --config=win_clang --repo_env=TF_PYTHON_VERSION=3.11 //tensorflow/tools/pip_package:wheel --repo_env=WHEEL_NAME=tensorflow_cpu

پشتیبانی از پردازنده گرافیکی

برای ساخت بسته ساز TensorFlow با پشتیبانی GPU:

bazel build --config=opt --config=cuda --define=no_tensorflow_py_deps=true //tensorflow/tools/pip_package:build_pip_package

دستورات پاکسازی حافظه پنهان bazel برای رفع خطاهای ناشی از داده های ذخیره شده نامعتبر یا قدیمی، پاک کردن bazel با پرچم --expunge فایل ها را برای همیشه حذف می کند.

bazel clean 
bazel clean --expunge  

گزینه های ساخت Bazel

هنگام ساختن از این گزینه برای جلوگیری از مشکلات ایجاد بسته استفاده کنید: tensorflow:issue#22390

--define=no_tensorflow_py_deps=true

برای گزینه های ساخت به مرجع خط فرمان Bazel مراجعه کنید.

ساخت TensorFlow از منبع می تواند از مقدار زیادی RAM استفاده کند. اگر سیستم شما دارای محدودیت حافظه است، استفاده از رم Bazel را با استفاده از: --local_ram_resources=2048 محدود کنید.

در صورت ساخت با پشتیبانی از GPU، --copt=-nvcc_options=disable-warnings برای سرکوب پیام های هشدار nvcc اضافه کنید.

بسته را بسازید

برای ساخت یک بسته پیپ، باید پرچم --repo_env=WHEEL_NAME را مشخص کنید. بسته به نام ارائه شده، بسته ایجاد می شود. به عنوان مثال:

برای ساخت بسته CPU tensorflow:

bazel build //tensorflow/tools/pip_package:wheel --repo_env=WHEEL_NAME=tensorflow_cpu

برای ساخت بسته شبانه، tf_nightly به جای tensorflow تنظیم کنید، به عنوان مثال برای ساخت بسته شبانه CPU:

bazel build //tensorflow/tools/pip_package:wheel --repo_env=WHEEL_NAME=tf_nightly_cpu

در نتیجه، چرخ تولید شده در آن قرار خواهد گرفت

bazel-bin/tensorflow/tools/pip_package/wheel_house/

بسته را نصب کنید

نام فایل فایل .whl تولید شده به نسخه TensorFlow و پلتفرم شما بستگی دارد. برای نصب بسته pip install استفاده کنید، به عنوان مثال:

pip install bazel-bin/tensorflow/tools/pip_package/wheel_house/tensorflow-version-tags.whl

با استفاده از پوسته MSYS بسازید

TensorFlow همچنین می تواند با استفاده از پوسته MSYS ساخته شود. تغییرات فهرست شده در زیر را انجام دهید، سپس دستورالعمل های قبلی را برای خط فرمان بومی ویندوز ( cmd.exe ) دنبال کنید.

تبدیل مسیر MSYS را غیرفعال کنید

MSYS به طور خودکار آرگومان هایی را که شبیه مسیرهای یونیکس هستند به مسیرهای ویندوز تبدیل می کند، و این با bazel کار نمی کند. (برچسب //path/to:bin یک مسیر مطلق یونیکس در نظر گرفته می شود زیرا با یک اسلش شروع می شود.)

export MSYS_NO_PATHCONV=1
export MSYS2_ARG_CONV_EXCL="*"

PATH خود را تنظیم کنید

دایرکتوری های نصب Bazel و Python را به متغیر محیطی $PATH خود اضافه کنید. اگر Bazel در C:\tools\bazel.exe و Python در C:\Python\python.exe نصب شده است، PATH خود را با:

# Use Unix-style with ':' as separator
export PATH="/c/tools:$PATH"
export PATH="/c/path/to/Python:$PATH"

برای پشتیبانی از GPU، دایرکتوری های CUDA و cuDNN bin را به $PATH خود اضافه کنید:

export PATH="/c/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v11.0/bin:$PATH"
export PATH="/c/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v11.0/extras/CUPTI/libx64:$PATH"
export PATH="/c/tools/cuda/bin:$PATH"

تنظیمات ساخت تست شده

CPU

پردازنده گرافیکی