이미지 분석 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를 참조하세요.

Terminal

C#용 이미지 분석 SDK는 .NET CLI에서 설치할 수 있습니다. 프로젝트 파일에 패키지 참조를 추가하려면 .csproj 파일이 있는 폴더에서 다음 명령을 실행합니다.

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

PowerShell

C#용 이미지 분석 SDK는 .NET CLI에서 설치할 수 있습니다. 프로젝트 파일에 패키지 참조를 추가하려면 .csproj 파일이 있는 폴더에서 다음 명령을 실행합니다.

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

Visual Studio

Visual Studio를 열고 새 애플리케이션 프로젝트를 만듭니다. 그런 후, 솔루션 탐색기에서 프로젝트 솔루션을 마우스 오른쪽 단추로 클릭하고 NuGet 패키지 관리를 선택하여 클라이언트 SDK를 설치합니다. 열리는 패키지 관리자에서 찾아보기를 선택하고, 시험판 포함을 선택하고, Azure.AI.Vision.ImageAnalysis를 검색합니다. 설치를 선택합니다.

참조 설명서 | 패키지(PiPy) | 샘플

이 가이드에서는 Python용 이미지 분석 SDK를 설치하는 방법을 보여 줍니다.

플랫폼 요구 사항

Python용 이미지 분석 SDK는 Windows, Linux 및 macOS와 호환됩니다.

Python용 이미지 분석 SDK 설치

Python용 이미지 분석 SDK를 설치하기 전에 플랫폼 요구 사항을 충족하는지 확인합니다.

도구 또는 IDE 선택

Terminal

터미널에서 설치

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을 검색하고 Microsoft에서 게시한 Visual Studio Code에 대한 Python 확장을 찾은 다음, 설치를 선택합니다.

   

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와 호환됩니다.

• JDK(Java Development Kit) 버전 8 이상이 설치되어 있습니다.

Windows

Windows에서는 64비트 대상 아키텍처를 사용해야 합니다. Windows 10 이상이 필요합니다.

Java SDK는 네이티브 이진 파일을 사용합니다. 플랫폼에 대해 Microsoft Visual Studio용 Visual C++ 재배포 가능 패키지 2015, 2017, 2019, 2022를 설치해야 합니다. 이 패키지를 처음 설치하려면 다시 시작해야 할 수 있습니다.

Linux

Java용 이미지 분석 SDK는 Linux와 함께 사용할 경우 x64 아키텍처에서 Ubuntu 18.04/20.04/22.04 및 Debian 9/10/11만 지원합니다.

Important

Linux 배포판의 최신 LTS 릴리스를 사용합니다. 예를 들어 Ubuntu 20.04 LTS를 사용하는 경우 최신 릴리스의 Ubuntu 20.04.X를 사용합니다.

이미지 분석 SDK는 다음 Linux 시스템 라이브러리에 따라 달라집니다.

• GNU C 라이브러리의 공유 라이브러리(POSIX Threads Programming 라이브러리, libpthreads 포함)
• OpenSSL 라이브러리(libssl) 버전 1.x

Important

이미지 분석 SDK는 아직 Ubuntu 22.04 및 Debian 12의 기본값인 OpenSSL 3.0을 지원하지 않습니다.

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

설치 시 참고사항:

• 사용할 최신 OpenSSL 1.x 버전은 https://www.openssl.org/source/을 확인하세요.
• 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를 사용하려면 Alpine Linux Wiki의 glibc 프로그램 실행에 설명된 대로 Debian chroot 환경을 만듭니다. 그런 다음, 여기에서 Debian 지침을 따릅니다.

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

JAVA 개발 키트

Java 8 이상이 필요합니다.

Azul Zulu OpenJDK, OpenJDK의 Microsoft Build, Oracle Java 또는 원하는 JDK와 같은 JDK(Java Development Kit)를 설치합니다.

성공적인 설치를 확인하고 버전을 확인하려면 명령줄에서 java -version을 실행합니다. Java 설치가 시스템 아키텍처에 기본적으로 설치되어 있고 에뮬레이션을 통해 실행되지 않는지 확인합니다.

Java용 이미지 분석 SDK 설치

Java용 이미지 분석 SDK는 Maven 패키지로 제공됩니다. 자세한 내용은 Maven 리포지토리의 azure-ai-vision-imageanalytic 패키지를 참조하세요.

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. azure-ai-vision-imageanalytic 패키지에 대한 Maven 리포지토리에서 찾은 최신 버전을 기반으로 <version>1.0.0-beta.1</version>의 버전 값을 업데이트합니다.

6. 다음 Maven 명령을 실행하여 이미지 분석 SDK 및 종속성을 설치합니다.

   mvn clean dependency:copy-dependencies
   

7. 로컬 폴더 경로 target\dependency가 만들어졌고 여기에 azure-ai-vision-*.jar라는 세 개의 파일을 포함하여 .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. azure-ai-vision-imageanalytic 패키지에 대한 Maven 리포지토리에서 찾은 최신 버전을 기반으로 com.azure:azure-ai-vision-imageanalysis:1.0.0-beta.1의 버전 값을 업데이트합니다.
6. 이미지 분석 SDK를 사용하여 이미지 분석을 수행하고 애플리케이션을 컴파일 및 실행하려면 Java 애플리케이션을 업데이트합니다.

참조 설명서 | 패키지(npm) | 샘플

이 가이드에서는 JavaScript용 이미지 분석 SDK를 설치하는 방법을 보여 줍니다.

플랫폼 요구 사항

JavaScript용 이미지 분석 SDK는 Windows, Linux 및 macOS와 호환됩니다.

JavaScript용 이미지 분석 SDK 설치

npm을 사용하여 JavaScript용 이미지 분석 클라이언트 라이브러리를 설치합니다.

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

다음 단계

이미지 분석 빠른 시작을 따라 시작합니다.