Compartir a través de


Migración al SDK de App Center 4.0.0 y versiones posteriores

Importante

Visual Studio App Center se retiró el 31 de marzo de 2025, excepto las características de análisis y diagnóstico, que seguirán siendo compatibles hasta el 30 de junio de 2026. Más información.

Para evitar un conflicto de nomenclatura con las clases de los marcos privados de Apple, el SDK ahora utiliza el prefijo MSAC en lugar de MS, lo que cambia la API del SDK.

La API de Swift tiene ahora un estilo más rápido y todas las clases deben usarse sin prefijo, por ejemplo, AppCenter. También hay cambios en las funciones y la nomenclatura de propiedades en función de los procedimientos recomendados de Apple Swift.

Actualización del SDK de App Center

En primer lugar, actualice el SDK de App Center mediante uno de los administradores de dependencias.

Uso de las APIs

La forma más rápida y cómoda de actualizar la API del SDK de App Center es usar autocorrección. Después del reemplazo, debería obtener el resultado como se muestra a continuación.

Antes de actualizar el SDK de App Center a 4.0.0 y versiones posteriores.

[MSAppCenter start:@"{Your App Secret}" withServices:@[[MSAnalytics class], [MSCrashes class]]];
MSAppCenter.start("{Your App Secret}", withServices: [MSAnalytics.self, MSCrashes.self])

Después de actualizar el SDK de App Center a 4.0.0 y versiones posteriores.

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];
AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

Además, el captador [MSACWrapperCrashesHelper getCrashHandlerSetupDelegate] ya está en desuso, use [MSACWrapperCrashesHelper crashHandlerSetupDelegate] en su lugar.

En las tablas siguientes se muestran las API cuyo nombre se ha cambiado.

App Center Core más bajo 4.0.0 App Center Core 4.0.0+ (ObjC) App Center Core 4.0.0+ (Swift)
MSAppCenter MSACAppCenter AppCenter
MSLogLevel MSACLogLevel LogLevel
MSLogLevelVerbose MSACLogLevelVerbose LogLevel.verbose
MSLogLevelWarning MSACLogLevelWarning .advertencia
MSLogLevelInfo MSACLogLevelInfo .info
MSLogLevelAssert MSACLogLevelAssert .afirmar
MSLogHandler MSACLogHandler LogHandler
MSLogMessageProvider MSACLogMessageProvider LogMessageProvider
Análisis de la parte inferior de App Center 4.0.0 Análisis de App Center 4.0.0+ (ObjC) App Center Analytics 4.0.0+ (Swift)
MSAnalytics MSACAnalytics Análisis de datos
MSFlags MSACFlags Banderas
MSFlagsNormal MSACFlagsNormal Flags.normal
MSFlagsCritical MSACFlagsCritical .crítico
MSFlagsDefault MSACFlagsDefault .predeterminado
MSEventProperties MSACEventProperties EventProperties
App Center se bloquea más abajo 4.0.0 Errores de App Center 4.0.0+ (ObjC) Fallos de 4.0.0App Center + (Swift)
MSCrashes MSACCrashes Accidentes
MSCrashesDelegate MSACCrashesDelegate CrashesDelegate
MSErrorReport MSACErrorReport Informe de Errores
RegistroDeAdjuntosDeErrorMS RegistroDeAdjuntosDeErroresMSAC RegistroAdjuntoDeErrores
MSConfirmaciónUsuarioNoEnviar MSACConfirmaciónUsuarioNoEnviar ConfirmaciónUsuario.noEnviar
MSUserConfirmationSend MSACConfirmaciónUsuarioEnviar .Enviar
MSUserConfirmationAlways MSACUserConfirmationAlways .siempre
MSGestorDeConfirmaciónDeUsuario MSACUserConfirmationHandler ManejadorDeConfirmaciónDeUsuario
App Center Distribute inferior 4.0.0 App Center Distribute 4.0.0+ (ObjC) App Center Distribute 4.0.0+ (Swift)
MSDistribute MSACDistribute Distribuir
MSDistributeDelegate MSACDistributeDelegate Delegado de Distribución
MSCrashHandlerSetupDelegate MSACCrashHandlerSetupDelegate CrashHandlerSetupDelegate
DetallesDeLanzamientoMS DetallesDeLanzamientoMSAC Detalles del Lanzamiento
MSUpdateAction MSACUpdateAction UpdateAction
ActualizaciónDeAcciónDeMS AcciónDeActualizaciónMSAC UpdateAction.actualizar
MSActualizarAcciónPosponer AcciónActualizarDeMSACPosponer .posponer
MSUpdateTrack MSACUpdateTrack UpdateTrack
MSUpdateTrackPublic MSACUpdateTrackPublic UpdateTrack.public
MSUpdateTrackPrivate MSACUpdateTrackPrivate .privado

Cambios en la API de Swift

App Center Core más bajo 4.0.0 App Center Core 4.0.0+
MSAppCenter.isEnabled() AppCenter.activado
MSAppCenter.setEnabled(true) AppCenter.enabled = true
MSAppCenter.isConfigured() AppCenter.isConfigured
MSAppCenter.isRunningInAppCenterTestCloud() AppCenter.isRunningInAppCenterTestCloud
MSAppCenter.isAppDelegateForwarderEnabled() AppCenter.isAppDelegateForwarderEnabled
MSAppCenter.installId() AppCenter.installId
MSAppCenter.isDebuggerAttached() AppCenter.isDebuggerAttached
MSAppCenter.sdkVersion() AppCenter.sdkVersion
MSAppCenter.setLogUrl("{Log Url}") AppCenter.logUrl = "{Log Url}"
MSAppCenter.setLogLevel(.verbose) AppCenter.logLevel = .verbose
MSAppCenter.setLogHandler(logHandler) AppCenter.logHandler = logHandler
MSAppCenter.SetUserId("{User Id}") AppCenter.userId = "{Id. de usuario}"
MSAppCenter.setCountryCode("{Country Code}") AppCenter.countryCode = "{Country Code}"
MSAppCenter.setAppSecret("{App Secret}") AppCenter.appSecret = "{App Secret}"
MSAppCenter.setString("value", forKey: "key") AppCenter.setString("value", para: "key")
MSServiceAbstract.isAppSecretRequired() ServiceAbstract.requiereSecretoDeAplicación
MSAppCenter.addChannelUnitWithConfiguration(configuration) AppCenter.addChannelUnit(withConfiguration:configuration)
MSAppCenter.configureWithAppSecret("{App Secret}") AppCenter.configure(withAppSecret:"{App Secret}")
MSAppCenter.start("{App Secret}", withServices: [MSAnalytics.self]) AppCenter.start(withAppSecret: "{App Secret}", services: [Analytics.self])
MSAppCenter.startWithServices([MSAnalytics.self, MSCrashes.self]) AppCenter.start(services: [Analytics.self, Crashes.self])
MSAppCenter.startFromLibraryWithServices([MSAnalytics.self]) AppCenter.startFromLibrary(services: [Analytics.self]) ")
Análisis de la parte inferior de App Center 4.0.0 Análisis de App Center 4.0.0+
MSAnalytics.isEnabled() Análisis.habilitado
MSAnalytics.setEnabled(true) Analytics.enabled = true
MSAnalytics.setTransmissionInterval(600) Analytics.transmissionInterval = 600
App Center se bloquea más abajo 4.0.0 Fallos de App Center 4.0.0+
MSCrashes.isEnabled() Crashes.enabled
MSCrashes.setEnabled(true) Crashes.enabled = true
MSCrashes.setDelegate(delegate) Crashes.delegate = delegate
MSCrashes.hasCrashedInLastSession() Crashes.hasCrashedInLastSession
MSCrashes.hasReceivedMemoryWarningInLastSession() Crashes.hasReceivedMemoryWarningInLastSession
MSErrorReport.isAppKill() ErrorReport.isAppKill
MSCrashes.lastSessionCrashReport() Crashes.lastSessionCrashReport
MSCrashes.setAutomaticProcessing(true) Crashes.automaticProcessing = true
MSWrapperCrashesHelper.getCrashHandlerSetupDelegate WrapperCrashesHelper.crashHandlerSetupDelegate
MSWrapperCrashesHelper.setCrashHandlerSetupDelegate(delegate) WrapperCrashesHelper.crashHandlerSetupDelegate = delegate
MSCrashes.setUserConfirmationHandler(handler) Crashes.userConfirmationHandler = handler
App Center Distribute inferior 4.0.0 Distribución de App Center 4.0.0+
MSDistribute.isEnabled() Distribute.enabled
MSDistribute.setEnabled(true) Distribuir.habilitado = true
MSDistribute.setDelegate(delegate) Distribute.delegate = delegate
MSDistribute.setApiUrl("{API URL}") Distribute.apiUrl = "{API URL}"
MSDistribute.setInstallUrl("{Install URL}") Distribute.installUrl = "{Instal URL}"
MSDistribute.esActualizaciónObligatoria Distribuir.actualizaciónObligatoria

Cambios en el Delegado de Errores

Antes de actualizar el SDK de App Center a 4.0.0 y versiones posteriores.

func crashes(_ crashes: MSCrashes!, shouldProcessErrorReport errorReport: MSErrorReport!) -> Bool

func crashes(_ crashes: MSCrashes!, willSend errorReport: MSErrorReport!)

func crashes(_ crashes: MSCrashes!, didSucceedSending errorReport: MSErrorReport!)

func crashes(_ crashes: MSCrashes!, didFailSending errorReport: MSErrorReport!, withError error: Error!)

func attachments(with crashes: MSCrashes, for errorReport: MSErrorReport) -> [MSErrorAttachmentLog]

Después de actualizar el SDK de App Center a 4.0.0 y versiones posteriores.

func crashes(_ crashes: Crashes, shouldProcess errorReport: ErrorReport) -> Bool

func crashes(_ crashes: Crashes, willSend errorReport: ErrorReport)

func crashes(_ crashes: Crashes, didSucceedSending errorReport: ErrorReport)

func crashes(_ crashes: Crashes, didFailSending errorReport: ErrorReport, withError error: Error)

func attachments(with crashes: Crashes, for errorReport: ErrorReport) -> [ErrorAttachmentLog]

Cambios en DistributeDelegate

Antes de actualizar el SDK de App Center a 4.0.0 y versiones posteriores.

func distribute(_ distribute: MSDistribute!, releaseAvailableWith details: MSReleaseDetails!) -> Bool

Después de actualizar el SDK de App Center a 4.0.0 y versiones posteriores.

  func distribute(_ distribute: Distribute, releaseAvailableWith details: ReleaseDetails) -> Bool