英特爾 oneAPI 執行緒建置模組

產品資訊

一個 API 線程構建塊（1 TB）

oneAPI 執行緒建構區塊 (oneTBB) 是一種基於運行時的平行程式設計模型，適用於使用執行緒的 C++ 程式碼。它是一個基於模板的運行時庫，旨在幫助利用多核心處理器的潛在效能。 oneTBB 透過將計算分解為平行運行的任務來簡化平行編程。並行性是透過執行緒在單一進程內執行的，執行緒是一種作業系統機制，可以同時執行相同或不同的指令集。

oneTBB 可以作為獨立產品或作為英特爾(R) oneAPI 基礎工具包的一部分進行下載。該產品附帶了一組在安裝前應滿足的系統要求。

系統需求

• 請參閱 oneTBB 系統需求。

安裝

• 下載 oneTBB 作為獨立產品或作為英特爾(R) oneAPI 基礎工具包的一部分。
• 請參閱獨立版本（Windows* 作業系統和 Linux* 作業系統）的安裝指南和英特爾(R) oneAPI 工具包安裝指南。

使用說明

• • 安裝oneTBB後，進入oneTBB安裝目錄設定環境變數。預設情況下，安裝目錄如下：

對於 Linux* 作業系統：/opt/intel/Konami/tab/latest/env/vars.sh

對於 Windows* 作業系統：%ProgramFiles(x86)%InteloneAPItbblatestenvvars.bat

• • 使用 pkg-config 工具在 Linux* 作業系統和 macOS* 上使用 oneTBB 編譯程式。提供搜尋的完整路徑，包括 file和庫，或提供像這樣的簡單行：

g++ -o test test.cpp $(pkg-config –libs –flags 選項卡)

• 對於 Windows* 作業系統，另外使用 –msvc-syntax 選項標誌，以適當的模式轉換編譯和連結標誌。
• 請參閱 GitHub 上的開發人員指南和 API 參考，以了解詳細說明、已知問題和變更。

開始使用一個 API 線程構建塊（1 TB）

• oneAPI 執行緒建構塊 (oneTBB) 是一種基於運行時的平行程式設計模型，適用於使用執行緒的 C++ 程式碼。它包含一個基於模板的運行時庫，可幫助您利用多核心處理器的潛在效能。
  oneTBB 使您能夠透過將計算分解為並行運行的任務來簡化平行程式設計。
• 在單一進程中，並行性是透過執行緒來實現的，執行緒是一種作業系統機制，允許同時執行相同或不同的指令集。
• 在這裡您可以看到執行緒可能執行的任務之一。

使用一個選項卡即可編寫可擴展的應用程式：

• 指定邏輯並行結構而不是線程
• 強調數據並行編程
• 採取先進tag並發集合和平行演算法
• oneTBB 支援巢狀並行和負載平衡。這意味著您可以使用該庫而不必擔心系統超額訂閱。 oneTBB 可作為獨立產品和英特爾® oneAPI 基礎工具包的一部分提供。

系統需求

• 請參閱 oneTBB 系統需求。

下載英特爾(R) oneAPI 執行緒建置模組 (oneTBB)

• 下載 oneTBB 作為獨立產品或作為英特爾(R) oneAPI 基礎工具包的一部分。請參閱獨立版本（Windows* 作業系統和 Linux* 作業系統）的安裝指南和英特爾(R) oneAPI 工具包安裝指南。

開始之前

安裝oneTBB後，需要設定環境變數：

1. 前往 oneTBB 安裝目錄（ ）。預設情況下，如下：
   1. 在 Linux* 作業系統上：
   2. 對於超級使用者（root）： /opt/英特爾/科樂美
   3. 對於普通用戶（非root）： $HOME/英特爾/科樂美
   4. 在 Windows* 作業系統上：
   5. <Program Files>\Intel\oneAPI
2. 設定環境變量，使用腳本，透過運行
   • 在 Linux* 作業系統上： vars.{sh|csh} 中/tbb/最新/env
   • 在 Windows* 作業系統上： vars.bat 中/tbb/最新/env

Example
下面你可以找到一個典型的前任amponeTBB 演算法的檔案。的sample 計算從 1 到 100 的所有整數的總和。

oneAPI 執行緒建構區塊 (oneTBB) 與 pkg-config 工具

• pkg-config 工具用於透過檢索有關套件的資訊來簡化編譯行
  特殊元數據 files。它有助於避免大型硬編碼路徑並使編譯更加可移植。

使用 pkg-config 編譯程序

• 若要在 Linux* 作業系統和 macOS* 上使用 oneTBB 編譯測試程式 test.cpp，請提供完整路徑來搜尋 include file和庫，或提供像這樣的簡單行：

在哪裡：

• cflags 提供 oneTBB 函式庫，包含路徑：
• libs 提供英特爾(R) oneTBB 函式庫名稱以及尋找它的搜尋路徑：
• 筆記 對於 Windows* 作業系統，另外使用 –msvc-syntax 選項標誌，以適當的模式轉換編譯和連結標誌。

尋找更多

• 一個TBB 社群論壇
• 產品常見問題解答
• 支援請求
• 如果您需要 oneTBB 的支持，請使用這些資源。
• 發行說明 查找有關產品的最新信息，包括詳細說明、已知問題和更改。
• 文件: 開發者指南和API參考
• 學習使用 oneTBB。
• GitHub* 在開源中尋找 oneTBB 實作。

聲明和免責聲明

• 英特爾技術可能需要啟用硬件，軟件或服務才能激活。
• 沒有任何產品或組件是絕對安全的。
• 您的費用和結果可能會有所不同。
• © 英特爾公司。 英特爾、英特爾標識和其他英特爾標誌是英特爾公司或其子公司的商標。 其他名稱和品牌可能是其他人的財產。
• 本文檔未授予任何智慧財產權許可（明示或暗示、透過禁止反言或其他方式）。
• 所描述的產品可能包含設計缺陷或錯誤（稱為勘誤表），這可能會導致產品偏離已發布的規格。目前特徵勘誤表可依要求提供。
• 英特爾不承擔所有明示和暗示的保證，包括但不限於適銷性、特定用途的適用性和不侵權的暗示保證，以及因履行過程、交易過程或貿易使用而產生的任何保證。

在 Windows* 作業系統上安裝 oneTBB

• 本節介紹如何在 Windows* 作業系統電腦上部署 oneAPI 執行緒建置區塊 (oneTBB) 程式庫。
• 如果您打算將 oneTBB 作為英特爾® oneAPI 基礎工具套件的一部分進行安裝，請參閱英特爾(R) oneAPI 工具組安裝指南的相應部分。
• 如果您打算將 oneTBB 當作獨立產品安裝，請使用安裝程式 GUI 或您選擇的套件管理器依照下列說明進行操作。
• 了解如何使用 GUI 和套件管理器安裝 oneTBB： * 使用 GUI 安裝 * 使用套件管理器安裝

使用 GUI 安裝

步驟 1. 選擇首選安裝程序

1. 前往下載頁面。將顯示可用安裝程式的清單。
2. 決定您將使用的 Windows 安裝程式類型：
   • 線上安裝程式較小 file 大小，但在運作時需要永久的網路連線。
   • 離線安裝程式有更大的 file 大小，但僅需要互聯網連接才能下載安裝程序 file，然後離線運行。
3. 決定安裝程式類型後，點擊對應的連結開始下載。
4. 等待下載完成。

步驟 2. 準備安裝程序

對於離線安裝程式：

1. 運行.exe file 你已經下載了。安裝包提取器將啟動。
2. 指定解壓縮包的路徑 - 預設為 C:\Users\ \下載\w_tbb_oneapi_p_ _離線。
3. 如有必要，選擇刪除臨時提取的 file安裝後複選框。
4. 點擊提取。
   對於線上安裝程序，執行 .exe 後自動開始下載 file.

步驟 3. 運行設置

1. 如果您正在執行離線安裝程序，請按一下「繼續」繼續。線上安裝程式將自動進行。
2. 在「摘要」步驟中，勾選「我接受許可協議的條款」複選框。
3. 選擇安裝方式：

• 若要使用預設安裝設置，請選擇建議安裝。 oneTBB 將安裝在預設位置：%Program FIles (x86)%\Intel\oneAPI\.點擊“繼續”並繼續執行“整合 IDE”步驟。
• 若要修改安裝設置，請選擇自訂安裝並按一下自訂。您將繼續執行“選擇組件”步驟。然而，由於解決方案的性質，只能選擇一個TBB 以外的任何組件。在此模式下，您可以透過點擊視窗左下角的「變更」來變更預設安裝位置。

1. 在「整合 IDE」步驟中，程式會檢查是否可以部署與 Microsoft Visual Studio IDE 完全整合的 oneTBB - 為此，必須在目標電腦上安裝受支援的 IDE 版本。如果未安裝，您可以退出安裝並在安裝 IDE 後重新啟動，或繼續進行而不進行整合。
2. 在「軟體改進計劃」步驟中，選擇您喜歡的選項。然後點擊安裝開始安裝。
3. 等待該過程完成。然後按完成關閉安裝程式或前往已安裝的產品以檢查更新或執行其他操作。

筆記 安裝後記得配置環境變數。請參閱開始之前部分以了解相關資訊。

使用套件管理器安裝

• 若要使用套件管理器安裝 oneTBB，請執行文件中所述的相應命令：
• 康達
• 點
• 努格特
• 筆記 安裝後記得配置環境變數。請參閱開始之前部分以了解相關資訊。

升級1TBB

• oneTBB 2021.1以上版本支援無縫升級。若要將 oneTBB 升級到最新版本，請執行安裝程序，如上所述。
• 如果您曾經使用舊版本 (TBB)，請考慮新版本的 oneTBB 不提供向後相容性。參見待定修訂版amp：背景、變化和現代化的詳細資訊。另請參閱
• 從 TBB 遷移，了解有關遷移到 oneTBB 的更多資訊。

解除安裝oneTBB

• 若要解除安裝 oneTBB，請使用「應用程式和功能」或「程式和功能」。

在 Linux* 作業系統上安裝 oneTBB

• 本節介紹如何在 Linux* 電腦上部署 oneAPI 執行緒建置區塊 (oneTBB) 函式庫。選擇首選方式：
• 使用命令列安裝 oneTBB
• 使用選擇的套件管理器安裝 oneTBB：
• 康達
• 易於
• 百勝餐飲集團
• 畫中畫
• 努格特
• 筆記 您也可以使用 GUI 在 Linux* 作業系統電腦上安裝 1 TB。請參閱英特爾(R) oneAPI 安裝指南以了解更多資訊。

使用命令列安裝 oneTBB

• 要安裝 oneTBB，請根據您的角色執行以下命令之一：
• 根：
• 用戶：

在哪裡：

• 沉默的 – 以非互動（靜默）模式執行安裝程式。
• 尤拉 – 接受或拒絕最終使用者許可協議 (EULA)，支援的值：接受或拒絕（預設）。
• 成分 - 讓您自訂安裝的元件。

對於前amp樂：

使用套件管理器安裝 oneTBB

• 使用您選擇的套件管理器按照說明進行操作。

康達

• 本節提供有關透過以下方式安裝 oneAPI 執行緒建構塊 (oneTBB) 的一般說明：
• Conda* 套件管理器。有關其他安裝說明，請參閱 Conda 文件。
• 若要安裝 oneTBB，請執行以下命令：
• 您也可以使用： conda install -c intel/label/intel tbb-devel
• 筆記 請參閱英特爾(R) oneAPI 安裝指南，以了解如何設定 Conda。

易於

• 若要使用 APT* 安裝 oneTBB，請執行：
• 對於前amp樂：

筆記 請參閱英特爾(R) oneAPI 安裝指南，以了解如何設定 YUM。

若要使用 PIP* 安裝 oneTBB，請執行：

對於前amp樂：

努格特

若要使用命令列從 NuGet* 安裝 oneTBB，請執行下列操作：

1. 請造訪 nuget.org
2. 跑步：

筆記 請參閱英特爾(R) oneAPI 安裝指南，以了解如何設定 NuGet*。
筆記 安裝後記得配置環境變數。請參閱開始之前部分以了解相關資訊。

• oneTBB 2021.1以上版本支援無縫升級。若要將 oneTBB 升級到最新版本，請執行安裝程序，如上所述。
• 如果您曾經使用舊版本 (TBB)，請考慮新版本的 oneTBB 不提供向後相容性。參見待定修訂版amp：背景、變化和現代化的詳細資訊。另請參閱從 TBB 遷移，以了解有關遷移到 1 TB 的更多資訊。

文件/資源

英特爾 oneAPI 執行緒建置模組 [pdf] 使用者指南 oneAPI 執行緒建構區塊, 執行緒建構區塊, 建構區塊, 區塊

參考

• 使用者手冊