Instrucciones de integración del SDK de iOS

En este artículo se describe cómo integrar el SDK de iOS v9.x en el proyecto de Xcode. Para obtener instrucciones sobre cómo mostrar diferentes tipos de anuncios, consulta los bloques de anuncios del SDK de iOS.

Requisitos

  • La aplicación debe tener como destino iOS 15.0 o posterior.
  • Para solicitar anuncios, use un identificador de ubicación válido. Para los bloques de anuncios compatibles, puedes usar un id. de miembro y un código de inventario válidos.

Instalación

Importante

Swift Administrador de paquetes (SPM) es el método principal y recomendado para integrar el SDK de iOS. La compatibilidad de CocoaPods se interrumpirá en la próxima versión del SDK.

Elija un método de instalación:

Método Estado
Administrador de paquetes Swift Recomendado
XCFramework Integración manual
Cartago Integración alternativa
CocoaPods Finalización del soporte

Administrador de paquetes Swift

  1. Abra el proyecto en Xcode.

  2. Seleccione el proyecto en el navegador de proyectos y, a continuación, seleccione Dependencias del paquete.

  3. Seleccione el botón para agregar una dependencia de + paquete.

    Captura de pantalla del panel Dependencias de paquete en Xcode.

  4. Escriba la siguiente dirección URL del paquete en el cuadro de búsqueda y, a continuación, presione Retorno:

    https://github.com/appnexus/mobile-sdk-ios-spm

    Captura de pantalla de la dirección URL del paquete SDK de iOS especificada en Xcode.

  5. Elija la configuración de versión que se adapte a su proyecto. Para proyectos nuevos, seleccione Hasta la siguiente versión principal. Luego seleccione Agregar paquete.

  6. En la ventana Elegir paquetes de productos para mobile-sdk-ios-spm , selecciona AppNexusSDK y el destino de la aplicación. Luego seleccione Agregar paquete.

    Captura de pantalla de la selección de productos AppNexusSDK en Xcode.

  7. Comprueba que AppNexusSDK aparezca en Dependencias del paquete.

Métodos de instalación alternativos

Use estos métodos solo cuando el Administrador de paquetes Swift no cumpla los requisitos de su proyecto.

XCFramework

Descargue el SDK de iOS v9.14.0. El archivo ZIP contiene los siguientes marcos y la agrupación de recursos. Usa AppNexusSDK para una integración general.

Marco Description
AppNexusSDK Admite todos los tipos de anuncios.
AppNexusNativeSDK Este marco solo admite anuncios nativos en iOS.
AppNexusNativeMacOSSDK Este marco solo admite anuncios nativos en macOS.
ANSmartAdapter Un adaptador de mediación para Smart Ad Server.
ANGoogleAdapter Un adaptador de mediación para AdMob de Google.
ANFacebookCSRAdapter Un adaptador de representación del lado cliente para Facebook Audience Network.
ANVungleAdapter Un adaptador de mediación para Vungle.
ANSDKResources.bundle Contiene los archivos necesarios que usa el SDK.

  1. Abre el proyecto o el área de trabajo de Xcode de la aplicación.

  2. Vaya a la página de configuración general del destino de la aplicación.

  3. Para usar el AppNexusSDK, agregue el AppNexusSDK.xcframework comando y .ANSDKResources.bundle

  4. Para importar el AppNexusSDK.xcframework:

    • Vaya a la configuración de Destino del proyecto.
    • Vaya a General de destino>.
    • Haga clic en el + botón de la sección Marcos, bibliotecas y contenido incrustado .
    • Haga clic en Agregar otro y, a continuación, en Agregar Files.
    • Elija el AppNexusSDK.xcframework archivo y haga clic en Abrir.

    Captura de pantalla de cómo añadir el XCFramework de AppNexusSDK en Xcode.

  5. Para incluir el ANSDKResources.bundle:

    • Vaya a lafase de compilaciónde destino>.
    • Expanda la fila Copiar recursos de agrupación y haga clic en el + icono.
    • Elija el ANSDKResources.bundle archivo y haga clic en Abrir.

    Captura de pantalla de cómo agregar el paquete ANSDKResources en Xcode.

Cartago

Si no está familiarizado con Carthage, revise la documentación de Carthage. Después de instalar Carthage, siga estos pasos:

  1. Abra Terminal y vaya al directorio raíz del proyecto. Crear un cartfile:

    touch Cartfile

  2. Abra el archivo de carro en Xcode:

    open -a Xcode Cartfile

  3. Agregue las siguientes líneas al Cartfile:

    binary "https://adsdkprod.azureedge.net/mobile/ios/releases/carthage/AppNexusSDK.json"
binary "https://adsdkprod.azureedge.net/mobile/ios/releases/carthage/OMSDK_Microsoft.json"

    Sugerencia

    Use comillas rectas en el Cartfile. Carthage no reconoce las comillas tipográficas insertadas por algunos editores de texto.

  4. Guarde el archivo Cart y, a continuación, actualice las dependencias:

    carthage update --use-xcframeworks

  5. Agregar AppNexusSDKDynamic.xcframework y OMSDK_AppNexus.xcframeworkTarget>> GeneralEmbedded Binarios.

  6. Para un destino de aplicación, seleccione Embed & Sign. Para otros destinos, selecciona No insertar.

CocoaPods

Advertencia

La compatibilidad de CocoaPods se interrumpirá en la próxima versión del SDK. Utilice el Administrador de paquetes Swift para nuevas integraciones.

Si no está familiarizado con los CocoaPods, revise su documentación. Después de instalar CocoaPods, siga estos pasos:

  1. En Terminal, vaya al directorio raíz del proyecto y cree un archivo Pod:

    pod init

  2. Abra el Podfile, establezca la versión de la plataforma en 15.0 y agréguelo AppNexusSDK al destino:

    platform :ios, '15.0'
project 'FunBanner'

target 'FunBanner' do
  pod 'AppNexusSDK'
end

  3. Guarde el archivo Pod y, a continuación, instale la dependencia:

    pod install

  4. Cierre el proyecto de Xcode abierto y, a continuación, abra el archivo generado .xcworkspace .

  • Se actualizó por última vez el