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

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

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

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

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

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

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

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 -S git patch unzip

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

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

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

نصب پشتیبانی از 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 # [e.g. (C:/Python310)]
set PATH=path/to/python/Scripts # [e.g. (C:/Python310/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 مشکل tensorflow:issue#54578

set BAZEL_SH=C:/msys64/usr/bin/bash.exe 
set BAZEL_VS=C:/Program Files(x86)/Microsoft Visual Studio/2019/BuildTools 
set BAZEL_VC=C:/Program Files(x86)/Microsoft Visual Studio/2019/BuildTools/VC 

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

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

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

python ./configure.py

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

python ./configure.py
You have bazel 5.3.0 installed.
Please specify the location of python. [Default is C:\Python310\python.exe]:
Found possible Python library paths:
C:\Python310\lib\site-packages
Please input the desired Python library path to use.  Default is [C:\Python310\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. For using TensorFlow GPU on Windows, you will need to build/install TensorFlow in WSL2.

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:build_pip_package

فقط CPU

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

bazel build --config=opt //tensorflow/tools/pip_package:build_pip_package

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

برای ساخت بسته ساز 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 اضافه کنید.

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

دستور bazel build یک فایل اجرایی به نام build_pip_package ایجاد می کند — این برنامه ای است که بسته pip را می سازد. برای مثال، موارد زیر یک بسته .whl را در پوشه C:/tmp/tensorflow_pkg می‌سازد:

bazel-bin\tensorflow\tools\pip_package\build_pip_package C:/tmp/tensorflow_pkg

اگرچه امکان ساخت پیکربندی‌های CUDA و غیر CUDA در زیر درخت منبع یکسان وجود دارد، توصیه می‌کنیم هنگام تعویض بین این دو پیکربندی در درخت منبع یکسان bazel clean را اجرا کنید.

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

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

pip3 install C:/tmp/tensorflow_pkg/tensorflow-version-tags.whl

e.g. pip3 install C:/tmp/tensorflow_pkg/tensorflow-2.12.0-cp310-cp310-win_amd64.whl

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

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

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

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

export MSYS_NO_PATHCONV=1
export MSYS2_ARG_CONV_EXCL="*"

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

دایرکتوری های نصب 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

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