البناء من المصدر على نظام التشغيل Windows

أنشئ حزمة TensorFlow pip من المصدر وقم بتثبيتها على Windows.

الإعداد لنظام التشغيل Windows

قم بتثبيت أدوات الإنشاء التالية لتكوين بيئة تطوير Windows لديك.

قم بتثبيت تبعيات حزمة Python وTensorFlow

قم بتثبيت إصدار Python 3.9+ 64 بت لنظام التشغيل Windows . حدد النقطة كميزة اختيارية وأضفها إلى المتغير البيئي %PATH% .

قم بتثبيت تبعيات حزمة TensorFlow pip :

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

تم إدراج التبعيات في ملف setup.py ضمن REQUIRED_PACKAGES .

تثبيت بازل

قم بتثبيت Bazel ، أداة البناء المستخدمة لتجميع TensorFlow. بالنسبة لإصدار Bazel، راجع تكوينات البناء المختبرة لنظام التشغيل Windows. قم بتكوين Bazel لبناء C++ .

أضف موقع الملف القابل للتنفيذ Bazel إلى متغير البيئة %PATH% .

قم بتثبيت MSYS2

قم بتثبيت MSYS2 لأدوات الحاوية اللازمة لإنشاء 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++ 2022

تثبيت أدوات بناء Visual C++ 2022 . يأتي هذا مع Visual Studio Community 2022 ولكن يمكن تثبيته بشكل منفصل:

1. انتقل إلى تنزيلات Visual Studio ،
2. حدد أدوات لـ Visual Studio أو أدوات أخرى وإطار العمل والمواد القابلة لإعادة التوزيع ،
3. تحميل وتثبيت:
   • أدوات البناء لبرنامج Visual Studio 2022
   • Microsoft Visual C++ القابلة لإعادة التوزيع لبرنامج Visual Studio 2022

قم بتثبيت LLVM

1. انتقل إلى تنزيلات LLVM ،
2. قم بتنزيل وتثبيت LLVM المتوافق مع Windows في C:/Program Files/LLVM، على سبيل المثال، LLVM-17.0.6-win64.exe

تثبيت دعم GPU (اختياري)

راجع دليل دعم Windows GPU لتثبيت برامج التشغيل والبرامج الإضافية المطلوبة لتشغيل TensorFlow على وحدة معالجة الرسومات.

قم بتنزيل كود مصدر 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.

اختياري: إعداد المتغير البيئي

قم بتشغيل الأوامر التالية قبل تشغيل أمر الإنشاء لتجنب مشكلات إنشاء الحزمة: (إذا تم إعداد الأوامر أدناه أثناء تثبيت الحزم، فيرجى تجاهلها). قم بتشغيل 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: الإصدار #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 بإنشاء برنامج "منشئ الحزم". ثم تقوم بتشغيل منشئ الحزمة لإنشاء الحزمة.

قم ببناء منشئ الحزمة

تم تحديث Tensorflow:master repo لبناء 2.x افتراضيًا. قم بتثبيت Bazel واستخدم bazel build لإنشاء منشئ الحزم TensorFlow.

bazel build //tensorflow/tools/pip_package:wheel

وحدة المعالجة المركزية فقط

استخدم bazel لإنشاء منشئ حزم TensorFlow مع دعم وحدة المعالجة المركزية فقط:

البناء باستخدام 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

دعم GPU

لإنشاء منشئ حزم TensorFlow بدعم GPU:

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

أوامر لتنظيف ذاكرة التخزين المؤقت لـ bazel لحل الأخطاء الناتجة عن البيانات المخزنة مؤقتًا غير الصالحة أو القديمة، يقوم bazel clean باستخدام علامة --expunge بإزالة الملفات نهائيًا

bazel clean 
bazel clean --expunge  

خيارات بناء بازل

استخدم هذا الخيار عند الإنشاء لتجنب مشكلات إنشاء الحزمة: 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. اعتمادا على الاسم المقدم، سيتم إنشاء الحزمة. على سبيل المثال:

لبناء حزمة وحدة المعالجة المركزية Tensorflow:

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

لإنشاء حزمة ليلية، قم بتعيين tf_nightly بدلاً من tensorflow ، على سبيل المثال لإنشاء حزمة وحدة المعالجة المركزية الليلية:

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. قم بإجراء التغييرات المذكورة أدناه، ثم اتبع الإرشادات السابقة لسطر الأوامر الأصلي لنظام التشغيل Windows ( cmd.exe ).

تعطيل تحويل مسار MSYS

يقوم MSYS تلقائيًا بتحويل الوسائط التي تشبه مسارات Unix إلى مسارات Windows، وهذا لا يعمل مع bazel . (التسمية //path/to:bin تعتبر مسارًا مطلقًا لنظام Unix نظرًا لأنها تبدأ بشرطة مائلة.)

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"

للحصول على دعم وحدة معالجة الرسومات، أضف مجلدي 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"

تكوينات البناء التي تم اختبارها

وحدة المعالجة المركزية

GPU