Instalación del SDK de análisis de imágenes

Documentación de referencia | Paquete (NuGet) | Muestras

En esta guía se muestra cómo instalar el SDK de análisis de imágenes para C#.

Requisitos de la plataforma

El SDK de análisis de imágenes para C# es compatible con Windows, Linux y macOS.

• .NET instalado. Esta instalación también incluye la CLI de .NET.

Instalación del SDK de análisis de imágenes para C#

El SDK de análisis de imágenes para C# está disponible como paquete NuGet e implementa el estándar 2.0 de .NET. Para obtener más información, consulte Azure.AI.Vision.ImageAnalysis.

Terminal

El SDK de análisis de imágenes para C# se puede instalar desde la CLI de .NET. Para agregar una referencia de paquete en el archivo del proyecto, ejecute este comando en la carpeta donde se encuentra el archivo .csproj:

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

PowerShell

El SDK de análisis de imágenes para C# se puede instalar desde la CLI de .NET. Para agregar una referencia de paquete en el archivo del proyecto, ejecute este comando en la carpeta donde se encuentra el archivo .csproj:

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

Visual Studio

Abra Visual Studio y cree una nueva aplicación de consola. Luego, debe instalar el SDK de cliente. Para ello, haga clic con el botón derecho en la solución de proyectos en el Explorador de soluciones y seleccionar Administrar paquetes NuGet. En el administrador de paquetes que se abre, seleccione ExaminarIncluir versión preliminar y busque Azure.AI.Vision.ImageAnalysis. Seleccione Instalar.

Documentación de referencia | Paquete (PyPi) | Muestras

En esta guía se muestra cómo instalar el SDK de análisis de imágenes para Python.

Requisitos de la plataforma

El SDK de análisis de imágenes para Python es compatible con Windows, Linux y macOS.

Instalación del SDK de análisis de imágenes para Python

Antes de instalar el SDK de análisis de imágenes para Python, asegúrese de satisfacer los requisitos de la plataforma.

Elección de la herramienta o IDE

Terminal

Instalación desde un terminal

Para instalar el SDK de análisis de imágenes para Python, ejecute este comando en un terminal.

pip install azure-ai-vision-imageanalysis

Actualización al SDK de análisis de imágenes más reciente

Para actualizar al SDK de análisis de imágenes más reciente, ejecute este comando en un terminal:

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

Puede comprobar qué versión del SDK de análisis de imágenes para Python está instalada actualmente mediante la ejecución de este comando en un terminal:

pip list

VS Code

Instalación del SDK de análisis de imágenes mediante Visual Studio Code

Para instalar el SDK de análisis de imágenes para Python:

1. Descargue e instale Visual Studio Code.

2. Ejecute Visual Studio Code e instale la extensión de Python:

   1. Seleccione Archivo>Preferencias>Extensiones.
   2. Busque Python, busque la extensión de Python para Visual Studio Code publicada por Microsoft, y luego seleccione Install (Instalar).

   

3. Seleccione Terminal(Termoinal)>New Terminal(Nueva Terminal) para abrir una terminal dentro de Visual Studio Code.

4. En el indicador del terminal, ejecute el siguiente comando para instalar el paquete del SDK de análisis de imágenes para Python.

   pip install azure-ai-vision-imageanalysis
   

5. Para actualizar al SDK de análisis de imágenes más reciente, ejecute este comando en un terminal:

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

6. Puede comprobar qué versión del SDK de análisis de imágenes para Python está instalada actualmente mediante la ejecución de este comando:

   pip list
   

Para obtener más información sobre Visual Studio Code y Python, consulte la documentación de Visual Studio Code y el tutorial de Visual Studio Code Python.

Documentación de referencia | Paquete Maven | Muestras

En esta guía se muestra cómo instalar el SDK de análisis de imágenes para Java.

Requisitos de la plataforma

El SDK de análisis de imágenes para Java es compatible con Windows, Linux y macOS.

• Tener instalado el Kit de desarrollo de Java (JDK), versión 8 o posterior.

Windows

En Windows debe usar la arquitectura de destino de 64 bits. Se requiere Windows 10 o posterior.

El SDK de Java usa archivos binarios nativos. Debe instalar Microsoft Visual C++ Redistributable para Visual Studio 2015, 2017, 2019 y 2022 para su plataforma. Durante la primera instalación del paquete, es posible que deba reiniciar.

Linux

El SDK de análisis de imágenes para Java solo admite Ubuntu 18.04/20.04/22.04 y Debian 9/10/11 en la arquitectura x64 cuando se usa con Linux.

Importante

Use la versión LtS más reciente de la distribución de Linux. Por ejemplo, si usa Ubuntu 20.04 LTS, use la versión más reciente de Ubuntu 20.04.X.

El SDK de análisis de imágenes depende de las siguientes bibliotecas del sistema Linux:

• Las bibliotecas compartidas de la biblioteca GNU C, incluida la biblioteca de programación de subprocesos de POSIX, libpthreads.
• La biblioteca OpenSSL (libssl) versión 1.x

Importante

El SDK de análisis de imágenes aún no es compatible con OpenSSL 3.0, que es el valor predeterminado en Ubuntu 22.04 y Debian 12.

Para instalar OpenSSL 1.x desde los orígenes en sistemas basados en Debian/Ubuntu que no lo tengan, haga lo siguiente:

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

Notas sobre la instalación:

• Compruebe en https://www.openssl.org/source/ la versión más reciente de OpenSSL 1.x que se vaya a usar.
• El valor de SSL_CERT_DIR debe estar en vigor en todo el sistema o al menos en la consola desde la que se inician las aplicaciones que usan el SDK de análisis de imágenes; de lo contrario, OpenSSL 1.x instalado en /usr/local puede que no encuentre certificados.
• Asegúrese de que la salida de la consola de ldconfig -v incluya /usr/local/lib como debería en los sistemas modernos de forma predeterminada. Si no es así, establezca LD_LIBRARY_PATH (con el mismo ámbito que SSL_CERT_DIR) para agregar /usr/local/lib a la ruta de acceso de la 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 el SDK de análisis de imágenes en Alpine Linux, cree un entorno chroot en Debian como se documenta en la wiki de Alpine Linux en los programas glibc en ejecución. A continuación, siga las instrucciones de Debian disponibles aquí.

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

Kit de desarrollo de JAVA

Es necesario Java 8 o posterior.

Instale un kit de desarrollo java (JDK), como Azul Zulu OpenJDK, Microsoft Build of OpenJDK, Oracle Java o su JDK preferido.

Ejecute java -version desde una línea de comandos para confirmar la instalación correcta y ver la versión. Asegúrese de que la instalación de Java es nativa de la arquitectura del sistema y no se ejecuta mediante la emulación.

Instalación del SDK de análisis de imágenes para Java

El SDK de análisis de imágenes para Java está disponible como un paquete de Maven. Para obtener más información, consulte el paquete azure-ai-vision-imageanalysis en el repositorio de Maven.

Maven

Siga estos pasos para instalar el SDK de análisis de imágenes para Java mediante Apache Maven:

1. Instalación de Apache Maven. En Linux, instale desde los repositorios de distribución si está disponible.

2. Abra un símbolo del sistema y ejecute mvn -v para confirmar la instalación correcta.

3. Abra un símbolo del sistema donde quiera colocar el nuevo proyecto y cree un archivo pom.xml.

4. Copie el siguiente contenido XML en el archivo 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. Actualice el valor de versión en <version>1.0.0-beta.1</version> según la versión más reciente que encuentre en el repositorio de Maven para el paquete azure-ai-vision-imageanalysis.

6. Ejecute el siguiente comando de Maven para instalar el SDK de análisis de imágenes y las dependencias.

   mvn clean dependency:copy-dependencies
   

7. Compruebe que se creó la ruta de acceso target\dependency de la carpeta local y contiene archivos .jar que incluyen tres archivos denominados azure-ai-vision-*.jar

Gradle

1. Instalación de Gradle.
2. En un símbolo del sistema ejecute gradle -v para confirmar la instalación correcta.
3. Crear una aplicación Java con Gradle. Vea, por ejemplo: Compilar ejemplo de aplicaciones Java.
4. Actualice el archivo build.gradle insertando 4 nuevas dependencias:

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

5. Actualice el valor de versión en com.azure:azure-ai-vision-imageanalysis:1.0.0-beta.1 según la versión más reciente que encuentre en el repositorio de Maven para el paquete azure-ai-vision-imageanalysis.
6. Actualice la aplicación Java para realizar el análisis de imágenes mediante el SDK de análisis de imágenes, compile y ejecute la aplicación.

Documentación de referencia | Paquete (npm) | Muestras

En esta guía se muestra cómo instalar el SDK de análisis de imágenes para JavaScript.

Requisitos de la plataforma

El SDK de análisis de imágenes para JavaScript es compatible con Windows, Linux y macOS.

Instalación del SDK de análisis de imágenes para JavaScript

Instale la biblioteca cliente de análisis de imágenes para JavaScript con npm:

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

Pasos siguientes

Siga los artículos de inicio rápido de Image Analysis para comenzar.