Guía de Implementación y Despliegue para Android¶

Video Capture SDK .Net Video Edit SDK .Net Media Player SDK .Net Media Blocks SDK .Net

Introducción a los SDKs de VisioForge para Android¶

Los desarrolladores Android que trabajan con tecnologías .NET pueden aprovechar las potentes capacidades de los SDKs de VisioForge para integrar funcionalidad multimedia avanzada en sus aplicaciones. Los SDKs proporcionan soluciones robustas para manipulación, reproducción, captura y edición de medios en la plataforma Android usando tecnologías .NET.

El SDK de VisioForge para Android ofrece potentes capacidades para procesamiento, captura, edición y reproducción de video, todo optimizado para la plataforma Android mientras mantiene una experiencia de desarrollo multiplataforma consistente.

El proceso de despliegue en Android requiere consideración especial para gestión de paquetes, compatibilidad de dispositivos, permisos y optimización de rendimiento. Este documento proporciona instrucciones detalladas para asegurar que tu aplicación funcione sin problemas en dispositivos Android.

Requisitos del Sistema¶

Antes de comenzar tu proceso de implementación y despliegue en Android, asegúrate de que tu entorno de desarrollo cumpla los siguientes requisitos:

Requisitos del Dispositivo¶

Dispositivo Android con Android 10.0 o posterior
Arquitectura de procesador ARM o ARM64
Espacio de almacenamiento suficiente para activos de aplicación y procesamiento de medios
Hardware de cámara y micrófono (si se usan características de captura de video/audio)

Requisitos del Entorno de Desarrollo¶

Computadora con Windows, Linux o macOS
Visual Studio con cargas de trabajo .NET MAUI o Xamarin instaladas, JetBrains Rider o Visual Studio Code
.Net 8.0 SDK o posterior (se recomienda la última versión estable)
Android SDK con niveles de API apropiados instalados
Java Development Kit (JDK) 11 o posterior
Conocimiento básico de desarrollo .NET para Android

Soporte de Arquitectura¶

El SDK de VisioForge para Android proporciona soporte nativo para arquitecturas comunes de dispositivos Android:

Soporte ARM64¶

Optimizado para dispositivos Android modernos
Procesamiento de video acelerado por hardware
Rendimiento mejorado para operaciones de medios
Objetivo principal para la mayoría de las aplicaciones

Soporte ARM/ARMv7¶

Compatibilidad con dispositivos Android más antiguos
Fallbacks de software para aceleración de hardware cuando sea necesario
Enfoque equilibrado de rendimiento y compatibilidad

Proceso de Instalación y Configuración¶

Sigue estos pasos para configurar e implementar correctamente tu aplicación Android con VisioForge:

Crea un nuevo proyecto Android en tu IDE preferido (se recomienda Visual Studio o JetBrains Rider).
Agrega los paquetes NuGet requeridos a tu proyecto (detallado en la siguiente sección).
Configura los permisos necesarios en tu archivo AndroidManifest.xml.
Implementa la lógica de tu aplicación usando los componentes del SDK de VisioForge.
Compila, firma y despliega tu aplicación en dispositivos de prueba.

Gestión de Paquetes NuGet¶

El SDK de VisioForge para Android se distribuye a través de paquetes NuGet. Agrega los siguientes paquetes a tu proyecto Android:

VisioForge.CrossPlatform.Core.Android - Contiene los componentes de redistribución requeridos para aplicaciones Android, incluyendo bibliotecas no administradas.

Puedes agregar estos paquetes usando el NuGet Package Manager en tu IDE o agregando lo siguiente a tu archivo de proyecto:

<ItemGroup Condition="$(TargetFramework.Contains('-android'))">
  <PackageReference Include="VisioForge.CrossPlatform.Core.Android" Version="15.2.12" />
</ItemGroup>

Nota: Reemplaza los números de versión con las últimas versiones disponibles.

Integración de Biblioteca de Bindings Java¶

Las aplicaciones Android que usan el SDK de VisioForge requieren una Biblioteca de Bindings Java personalizada para la funcionalidad adecuada. Este paso esencial asegura la comunicación adecuada entre el framework .NET y el entorno basado en Java de Android.

Sigue estos pasos detallados para integrarla:

Clona el repositorio de la biblioteca de binding de nuestra página de GitHub
Basándote en tu versión de .NET, agrega uno de los siguientes proyectos a tu solución:
Para .NET 9: VisioForge.Core.Android.X9.csproj
Para .NET 8: VisioForge.Core.Android.X8.csproj
Agrega una referencia a la biblioteca auxiliar en el archivo .csproj de tu proyecto:

<ItemGroup>
  <ProjectReference Include="..\AndroidDependency\VisioForge.Core.Android.X9.csproj" />
</ItemGroup>

Nota: Asegúrate de ajustar la ruta relativa para que coincida con la estructura de tu proyecto

Implementando VideoView en Tu Aplicación¶

Agregando VideoView a Tu Diseño¶

El control VideoView es la interfaz principal para mostrar contenido de video en tu aplicación Android. Para integrarlo en tu app, sigue estos pasos:

Abre el archivo de diseño de tu Activity o Fragment (típicamente un archivo .axml o .xml)
Agrega el elemento VideoView como se muestra en el ejemplo a continuación:

<VisioForge.Core.UI.Android.VideoView
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:minWidth="25px"
    android:minHeight="25px"
    android:id="@+id/videoView" />

Inicializando VideoView en Código¶

Después de agregar el VideoView a tu diseño, necesitarás inicializarlo en el código de tu Activity o Fragment:

using VisioForge.Core.UI.Android;

namespace TuApp
{
    [Activity(Label = "VideoPlayerActivity")]
    public class VideoPlayerActivity : Activity
    {
        private VideoView _videoView;

        protected override void OnCreate(Bundle savedInstanceState)
        {
            base.OnCreate(savedInstanceState);
            SetContentView(Resource.Layout.your_layout);

            // Inicializar la vista de video
            _videoView = FindViewById<VideoView>(Resource.Id.videoView);
        }
    }
}

Consideraciones de Rendimiento¶

Usa dispositivos Android físicos para pruebas siempre que sea posible. Los simuladores pueden no representar con precisión el rendimiento del mundo real, especialmente para operaciones de video aceleradas por hardware.

Firma y Publicación de la Aplicación¶

Firma de la Aplicación¶

Para distribuir tu aplicación Android, necesitas firmarla con un certificado digital:

Crea un archivo keystore si aún no tienes uno:

keytool -genkey -v -keystore your-app-key.keystore -alias your-app-alias -keyalg RSA -keysize 2048 -validity 10000

Configura la firma en tu proyecto:

Agrega lo siguiente a tu archivo android/app/build.gradle:

android {
    ...

    signingConfigs {
        release {
            storeFile file("your-app-key.keystore")
            storePassword "your-store-password"
            keyAlias "your-app-alias"
            keyPassword "your-key-password"
        }
    }

    buildTypes {
        release {
            signingConfig signingConfigs.release
            ...
        }
    }
}

Para proyectos .NET MAUI o Xamarin.Android, configura la firma en tu archivo .csproj:

<PropertyGroup Condition="$(TargetFramework.Contains('-android')) and '$(Configuration)' == 'Release'">
    <AndroidKeyStore>True</AndroidKeyStore>
    <AndroidSigningKeyStore>your-app-key.keystore</AndroidSigningKeyStore>
    <AndroidSigningStorePass>your-store-password</AndroidSigningStorePass>
    <AndroidSigningKeyAlias>your-app-alias</AndroidSigningKeyAlias>
    <AndroidSigningKeyPass>your-key-password</AndroidSigningKeyPass>
</PropertyGroup>

Publicación en Google Play Store¶

Genera un AAB (Android App Bundle) para distribución:

dotnet build -f net8.0-android -c Release /p:AndroidPackageFormat=aab

Crea una cuenta de desarrollador en Google Play Console si aún no tienes una.
Crea una nueva aplicación en Google Play Console.
Sube tu archivo AAB a la pista de producción.
Completa la información del listado de la tienda.
Envía para revisión.

Solución de Problemas¶

Problemas Comunes¶

Permisos Faltantes: Asegúrate de que todos los permisos requeridos estén declarados en AndroidManifest.xml y solicitados en tiempo de ejecución.
Compatibilidad de Arquitectura: Verifica que tu aplicación soporte la arquitectura del dispositivo objetivo (ARM/ARM64).
Restricciones de Memoria: Monitorea el uso de memoria e implementa gestión adecuada de recursos.
Problemas de Rendimiento: Usa aceleración de hardware y optimiza las operaciones de medios para dispositivos móviles.
Errores de Java Bindings: Cuando enfrentes problemas con bindings Java:
Confirma que estás usando la versión correcta de la biblioteca de binding
Verifica desajustes de versión entre .NET y la biblioteca de binding
Verifica que todas las dependencias estén correctamente referenciadas

Obtener Ayuda¶

Si encuentras problemas con tu despliegue del SDK de VisioForge en Android, por favor consulta:

Conclusión¶

Implementar y desplegar aplicaciones del SDK de VisioForge en dispositivos Android requiere atención cuidadosa a consideraciones específicas de la plataforma. Siguiendo las guías en este documento, puedes asegurar un proceso de desarrollo y despliegue fluido y entregar aplicaciones de video de alta calidad a tus usuarios de Android.

Recuerda probar exhaustivamente en dispositivos objetivo, especialmente para operaciones intensivas de rendimiento como captura y procesamiento de video. Con la implementación adecuada, el SDK de VisioForge habilita potentes aplicaciones de medios en todo el ecosistema Android.