Instalar o SDK de Análise de Imagem

Documentação de referência | Pacote (NuGet) | Exemplos

Este guia mostra como instalar o SDK de Análise de Imagem para C#.

Requisitos de plataforma

O SDK de Análise de Imagem para C# é compatível com o Windows, Linux e macOS.

• .NET instalado. Essa instalação também inclui a CLI do .NET.

Instalar o SDK de Análise de Imagem para C#

O SDK de Análise de Imagem para C# está disponível como um pacote NuGet e implementa o .NET Standard 2.0. Para obter mais informações, consulte Azure.AI.Vision.ImageAnalysis.

Terminal

O SDK de Análise de Imagem para C# pode ser instalado por meio da CLI do .NET. Para adicionar uma referência de pacote no arquivo de projeto, execute esse comando na pasta em que o arquivo .csproj está localizado:

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

PowerShell

O SDK de Análise de Imagem para C# pode ser instalado por meio da CLI do .NET. Para adicionar uma referência de pacote no arquivo de projeto, execute esse comando na pasta em que o arquivo .csproj está localizado:

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

Visual Studio

Abra o Visual Studio e crie um projeto de aplicativo. Depois, instale o SDK do cliente clicando com o botão direito do mouse na solução do projeto no Gerenciador de Soluções e selecionando Gerenciar Pacotes do NuGet. No gerenciador de pacotes aberto, selecione Procurar, marque Incluir pré-lançamento e pesquise Azure.AI.Vision.ImageAnalysis. Selecione Instalar.

Documentação de referência | Pacote (PyPi) | Amostras

Este guia mostra como instalar o SDK de Análise de Imagem para Python.

Requisitos de plataforma

O SDK de Análise de Imagem para Python é compatível com o Windows, Linux e macOS.

Instalar o SDK de Análise de Imagem para Python

Antes de instalar o SDK de Análise de Imagem para Python, certifique-se de atender os requisitos da plataforma.

Escolha sua ferramenta ou IDE

Terminal

Instalar a partir do terminal

Para instalar o SDK de Análise de Imagem para Python, execute este comando em um terminal.

pip install azure-ai-vision-imageanalysis

Atualizar para o SDK de Análise de Imagem mais recente

Para atualizar para o SDK de Análise de Imagem mais recente, execute este comando em um terminal:

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

Verifique qual versão do SDK de Análise de Imagem para Python está instalada atualmente ao executar esse comando em um terminal:

pip list

VS Code

Instalar o SDK de Análise de Imagem usando o Visual Studio Code

Para instalar o SDK de Análise de Imagem para Python:

1. Baixe e instale o Visual Studio Code.

2. Execute o Visual Studio Code e instale a extensão do Python:

   1. Selecione Arquivo>Preferências>Extensões.
   2. Pesquisa Python, localize a extensão do Python para Visual Studio Code publicada pela Microsoft e selecione Instalar.

   

3. Selecione Terminal>Novo Terminal para abrir um terminal no Visual Studio Code.

4. No prompt do terminal, execute o comando a seguir para instalar o pacote do SDK de Análise de Imagem para Python.

   pip install azure-ai-vision-imageanalysis
   

5. Para atualizar para o SDK de Análise de Imagem mais recente, execute este comando em um terminal:

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

6. Verifique qual versão do SDK de Análise de Imagem para Python está instalada atualmente ao executar esse comando:

   pip list
   

Para obter mais informações sobre o Visual Studio Code e o Python, confira a documentação do Visual Studio Code e o tutorial do Visual Studio Code para Python.

Documentação de referência | Pacote Maven | Amostras

Este guia mostra como instalar o SDK de Análise de Imagem para Java.

Requisitos de plataforma

O SDK de Análise de Imagem para Java é compatível com o Windows, Linux e macOS.

• JDK (kit de desenvolvimento do Java) versão 8 ou superior.

Windows

No Windows, você precisa usar a arquitetura de destino de 64 bits. Windows 10 ou posterior é necessário.

O SDK do Java usa binários nativos. Você precisa instalar os Pacotes Redistribuíveis do Microsoft Visual C++ para Visual Studio 2015, 2017, 2019 ou 2022 na sua plataforma. Quando você instalar esse pacote pela primeira vez, poderá ser necessária uma reinicialização.

Linux

O SDK de Análise de Imagem para Java dá suporte apenas ao Ubuntu 18.04/20.04/22.04 e Debian 9/10/11 na arquitetura x64 quando usado no Linux.

Importante

Use a versão LTS mais recente da distribuição do Linux. Por exemplo, se você estiver usando o Ubuntu 20.04 LTS, use a versão mais recente do Ubuntu 20.04.X.

O SDK de Análise de Imagem depende das seguintes bibliotecas do sistema Linux:

• As bibliotecas compartilhadas da biblioteca GNU C, incluindo a biblioteca de Programação de Threads POSIX, libpthreads
• A biblioteca OpenSSL (libssl) versão 1.x

Importante

O SDK de Análise de Imagem ainda não dá suporte ao OpenSSL 3.0, que é o padrão no Ubuntu 22.04 e Debian 12.

Para instalar o OpenSSL 1.x a partir de fontes em sistemas baseados em Debian/Ubuntu que não o tenham, faça o seguinte:

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

Observações sobre a instalação:

• Acesse https://www.openssl.org/source/ para conferir a versão mais recente do OpenSSL 1.x a ser usada.
• A configuração de SSL_CERT_DIR deve estar em vigor em todo o sistema ou pelo menos no console onde os aplicativos que usam o SDK de Análise de Imagem são iniciados. Caso contrário, talvez o OpenSSL 1.x instalado no /usr/local não encontre certificados.
• Verifique se a saída do console de ldconfig -v inclui /usr/local/lib como deveria incluir em sistemas modernos por padrão. Se esse não for o caso, defina LD_LIBRARY_PATH (com o mesmo escopo que SSL_CERT_DIR) para adicionar /usr/local/lib ao caminho da biblioteca:

  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

Para usar o SDK de Análise de Imagem no Alpine Linux, crie um ambiente chroot do Debian, conforme documentado na Wiki do Alpine Linux sobre a execução de programas glibc. Em seguida, siga as instruções do Debian descritas aqui.

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

Kit de desenvolvimento do JAVA

O Java 8 ou superior é necessário.

Instale um JDK (kit de desenvolvimento do Java), como Azul Zulu OpenJDK, Microsoft Build do OpenJDK, Oracle Java ou seu JDK preferido.

Execute java -version em uma linha de comando para confirmar a instalação bem-sucedida e visualizar a versão. Verifique se a instalação do Java é nativa da arquitetura do sistema e não está em execução por meio da emulação.

Instalar o SDK de Análise de Imagem para Java

O SDK de Análise de Imagem para Java está disponível como um pacote Maven. Para obter mais informações, consulte o pacote azure-ai-vision-imageanalysis no repositório do Maven.

Maven

Siga estas etapas para instalar o SDK de Análise de Imagem para Java usando o Apache Maven:

1. Instale o Apache Maven. No Linux, instale nos repositórios de distribuição, se disponível.

2. Abra um prompt de comando e execute mvn -v para confirmar a instalação bem-sucedida.

3. Abra um prompt de comando onde você quer alocar o novo projeto e crie um novo arquivo pom.xml.

4. Copie o seguinte conteúdo XML no arquivo 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. Atualize o valor da versão no <version>1.0.0-beta.1</version> com base na versão mais recente encontrada no repositório do Maven para o pacote azure-ai-vision-imageanalysis.

6. Execute o comando do Maven a seguir para instalar o SDK de Análise de Imagem e as dependências.

   mvn clean dependency:copy-dependencies
   

7. Verifique se o caminho target\dependency da pasta local foi criado e se ele contém arquivos .jar, incluindo três arquivos chamados azure-ai-vision-*.jar

Gradle

1. Instale o Gradle.
2. Em um prompt de comando execute gradle -v para confirmar a instalação bem-sucedida.
3. Crie um aplicativo Java usando o Gradle. Confira, por exemplo, Como compilar amostras de aplicativos Java.
4. Atualize o arquivo build.gradle inserindo 4 novas dependências:

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

5. Atualize o valor da versão no com.azure:azure-ai-vision-imageanalysis:1.0.0-beta.1 com base na versão mais recente encontrada no repositório do Maven para o pacote azure-ai-vision-imageanalysis.
6. Atualize o aplicativo Java para fazer a Análise de Imagem usando o SDK de Análise de Imagem, compile e execute o aplicativo.

Documentação de referência | Pacote (npm) | Amostras

Este guia mostra como instalar o SDK de Análise de Imagem para JavaScript.

Requisitos de plataforma

O SDK de Análise de Imagem para JavaScript é compatível com o Windows, Linux e macOS.

Instalar o SDK de Análise de Imagem para JavaScript

Instale a biblioteca de clientes de Análise de Imagem para JavaScript com npm:

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

Próximas etapas

Siga o guia de início rápido da Análise de Imagem para obter uma introdução.