安裝影像分析 SDK

參考文件 | 套件 (NuGet) | 範例

本指南說明如何安裝適用於 C# 的影像分析 SDK。

平台需求

適用於 C# 的影像分析 SDK 與 Windows、Linux 和 macOS 相容。

• 已安裝 .NET。 此安裝也包含 .NET CLI。

安裝適用於 C# 的影像分析 SDK

適用於 C# 的影像分析 SDK 可以 NuGet 套件的形式取得，並且實作 .NET Standard 2.0。 如需詳細資訊，請參閱 Azure.AI.Vision.ImageAnalysis。

終端機

您可以從 .NET CLI 安裝適用於 C# 的影像分析 SDK。 若要在專案檔中新增套件參考，請在 .csproj 檔案所在的資料夾中執行此命令：

dotnet add package  Azure.AI.Vision.ImageAnalysis --prerelease

PowerShell

您可以從 .NET CLI 安裝適用於 C# 的影像分析 SDK。 若要在專案檔中新增套件參考，請在 .csproj 檔案所在的資料夾中執行此命令：

Install-Package Azure.AI.Vision.ImageAnalysis --prerelease

Visual Studio

開啟 Visual Studio，並且建立新的應用程式專案。 然後以滑鼠右鍵按一下 [方案總管] 中的解決方案，並選取 [管理 NuGet 套件]，以安裝用戶端 SDK。 在開啟的套件管理員中，選取 [瀏覽]、核取 [包含發行前版本]，然後搜尋 Azure.AI.Vision.ImageAnalysis。 選取 [安裝]。

參考文件 | 套件 (PyPi) | 範例

本指南說明如何安裝適用於 Python 的影像分析 SDK。

平台需求

適用於 Python 的影像分析 SDK 與 Windows、Linux 和 macOS 相容。

安裝適用於 Python 的影像分析 SDK

在安裝適用於 Python 的影像分析 SDK 之前，請務必滿足平台需求。

選擇您的工具或 IDE

終端機

從終端機安裝

若要安裝適用於 Python 的影像分析 SDK，請在終端機中執行此命令。

pip install azure-ai-vision-imageanalysis

升級至最新的影像分析 SDK

若要升級至最新的影像分析 SDK，請在終端機中執行此命令：

pip install --upgrade azure-ai-vision-imageanalysis

您可以在終端機執行此命令，以檢查目前已安裝的適用於 Python 的影像分析 SDK 版本：

pip list

VS Code

使用 Visual Studio Code 安裝影像分析 SDK

若要安裝適用於 Python 的影像分析 SDK：

1. 下載並安裝 Visual Studio Code。

2. 執行 Visual Studio Code，然後安裝 Python 延伸模組：

   1. 選取 [檔案] > [喜好設定] > [延伸模組]。
   2. 搜尋 Python、尋找適用於 Visual Studio Code 的 python 延伸模組 (由 Microsoft 發行)，然後選取 [安裝]。

   

3. 選取 [終端機]>[新增終端機]，以在 Visual Studio Code 內開啟終端機。

4. 在終端提示字元中，執行以下命令以安裝適用於 Python 的影像分析 SDK 套件。

   pip install azure-ai-vision-imageanalysis
   

5. 若要升級至最新的影像分析 SDK，請在終端機中執行此命令：

   pip install --upgrade azure-ai-vision-imageanalysis
   

6. 您可以執行此命令，以檢查目前已安裝的適用於 Python 的影像分析 SDK 版本：

   pip list
   

如需 Visual Studio Code 和 Python 的詳細資訊，請參閱 Visual Studio Code 文件和 Visual Studio Code Python 教學課程。

參考文件 | Maven 套件 | 範例

本指南說明如何安裝適用於 Java 的影像分析 SDK。

平台需求

適用於 Java 的影像分析 SDK 與 Windows、Linux 和 macOS 相容。

• 已安裝 Java Development Kit (JDK) 第 8 版或更新版本。

Windows

在 Windows 上，您必須使用 64 位元目標結構。 需要 Windows 10 或更新版本。

Java SDK 使用原生二進位檔。 請為平台安裝適用於 Visual Studio 2015、2017、2019 和 2022 的 Microsoft Visual C++ 可轉散發套件。 第一次安裝此套件時可能需要重新啟動。

Linux

適用於 Java 的影像分析 SDK 在搭配 Linux 使用時，僅支援採用 x64 架構的 Ubuntu 18.04/20.04/22.04 和 Debian 9/10/11。

重要

使用 Linux 發行版本的最新 LTS 版本。 例如，如果您使用 Ubuntu 20.04 LTS，請使用最新版的 Ubuntu 20.04.X。

影像分析 SDK 取決於下列 Linux 系統程式庫：

• GNU C 程式庫的共用程式庫，包括 POSIX 執行緒程式設計程式庫 libpthreads
• OpenSSL 程式庫 (libssl) 1.x 版

重要

影像分析 SDK 尚未支援 OpenSSL 3.0，這是 Ubuntu 22.04 和 Debian 12 中的預設值。

若要在未安裝 OpenSSL 1.x 的 Debian/Ubuntu 系統上從資源安裝 OpenSSL 1.x，請執行下列動作：

wget -O - https://www.openssl.org/source/openssl-1.1.1u.tar.gz | tar zxf -
cd openssl-1.1.1u
./config --prefix=/usr/local
make -j $(nproc)
sudo make install_sw install_ssldirs
sudo ldconfig -v
export SSL_CERT_DIR=/etc/ssl/certs

安裝注意事項：

• 檢查 https://www.openssl.org/source/，以取得要使用的最新 OpenSSL 1.x 版本。
• SSL_CERT_DIR 的設定必須在整個系統內有效，或至少在使用影像分析 SDK 之應用程式所啟動的主控台中有效，否則 /usr/local 中已安裝的 OpenSSL 1.x 可能會找不到憑證。
• 請確保來自 ldconfig -v 的主控台的輸出會以預設包含在 /usr/local/lib 新式系統上。 如果不是這種情況，則請設定 LD_LIBRARY_PATH (與 SSL_CERT_DIR 範圍相同)，將 /usr/local/lib 新增至程式庫路徑：

  export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
  

Ubuntu 18.04/20.04/22.04

sudo apt-get update
sudo apt-get install build-essential libssl-dev wget

Debian 9/10/11

若要在 Alpine Linux 中使用影像分析 SDK，請建立 Debian chroot 環境 (如 Alpine Linux Wiki 中如何執行 glibc 程式的記載)。 然後遵循此處的 Debian 指示進行。

sudo apt-get update
sudo apt-get install build-essential libssl-dev wget

JAVA Development Kit

需要 Java 8 或更新版本。

安裝 Java Development Kit (JDK)，例如 Azul Zulu OpenJDK、Microsoft Build of OpenJDK、Oracle JAVA 或您慣用的 JDK。

從命令列執行 java -version 以確認安裝成功，並查看版本。 請確定 JAVA 安裝是系統架構的原生安裝，而且不會透過模擬執行。

安裝適用於 Java 的影像分析 SDK

適用於 Java 的影像分析 SDK 可以透過 Maven 套件形式取得。 如需詳細資訊，請參閱 Maven 存放庫中的 azure-ai-vision-imageanalysis。

Maven

遵循下列步驟，使用 Apache Maven 安裝適用於 Java 的影像分析 SDK：

1. 安裝 Apache Maven。 在 Linux上，從發行版本存放庫安裝 (如有)。

2. 開啟命令提示字元，並執行 mvn -v 以確認安裝成功。

3. 開啟您要在其中放置新專案的命令提示字元，並建立新的 pom.xml 檔案。

4. 將下列 XML 內容複製到您的 pom.xml 檔案：

   <project xmlns="http://maven.apache.org/POM/4.0.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>azure.ai.vision.imageanalysis.samples</groupId>
     <artifactId>image-analysis-quickstart</artifactId>
     <version>0.0</version>
     <dependencies>
       <dependency>
         <groupId>com.azure</groupId>
         <artifactId>azure-ai-vision-imageanalysis</artifactId>
         <version>1.0.0-beta.1</version>
       </dependency>
       <dependency>
         <groupId>org.slf4j</groupId>
         <artifactId>slf4j-nop</artifactId>
         <version>1.7.36</version> 
       </dependency>
     </dependencies>
   </project>
   

5. 根據您在 Maven 存放庫中找到的 azure-ai-vision-imageanalysis 套件的最新版本來更新 <version>1.0.0-beta.1</version> 中的版本值。

6. 執行下列 Maven 命令來安裝影像分析 SDK 和相依性。

   mvn clean dependency:copy-dependencies
   

7. 驗證已建立本機資料夾路徑 target\dependency，且其包含 .jar 檔案，包括三個名為 azure-ai-vision-*.jar 的檔案

Gradle

1. 安裝 Gradle。
2. 在命令提示字元中，執行 gradle -v 以確認安裝成功。
3. 使用 Gradle 建立您的 Java 應用程式。 如需範例，請參閱建置 Java 應用程式範例。
4. 插入 4 個新的相依性來更新您的 build.gradle 檔案：

   dependencies {
       implementation 'com.azure:azure-ai-vision-imageanalysis:1.0.0-beta.1'
       implementation 'org.slf4j:slf4j-nop:1.7.36'
   }
   

5. 根據您在 Maven 存放庫中找到的 azure-ai-vision-imageanalysis 套件的最新版本來更新 com.azure:azure-ai-vision-imageanalysis:1.0.0-beta.1 中的版本值。
6. 更新您的 Java 應用程式以使用影像分析 SDK 來執行影像分析，編譯並執行您的應用程式。

參考文件 | 套件 (npm) | 範例

本指南說明如何安裝適用於 JavaScript 的影像分析 SDK。

平台需求

適用於 JavaScript 的影像分析 SDK 與 Windows、Linux 和 macOS 相容。

安裝適用於 JavaScript 的影像分析 SDK

使用 npm 來安裝適用於 JavaScript 的影像分析用戶端程式庫：

npm install @azure-rest/ai-vision-image-analysis

下一步

請遵循影像分析快速入門以開始使用。