Migración a App Center SDK 4.0.0 y versiones posteriores
Importante
Visual Studio App Center está programado para la retirada el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.
Obtenga más información sobre las escalas de tiempo de soporte técnico y las alternativas.
Para evitar un conflicto de nomenclatura con las clases de los marcos privados de Apple, el SDK ahora usa MSAC el prefijo en lugar de MS los 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 un prefijo, por ejemplo AppCenter, . También hay cambios en la nomenclatura de funciones y 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 API
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 | .Información |
| MSLogLevelAssert | MSACLogLevelAssert | .Afirmar |
| MSLogHandler | MSACLogHandler | LogHandler |
| MSLogMessageProvider | MSACLogMessageProvider | LogMessageProvider |
Análisis de App Center inferior 4.0.0 |
Análisis de App Center 4.0.0+ (ObjC) |
App Center Alanlytics 4.0.0+ (Swift) |
|---|---|---|
| MSAnalytics | MSACAnalytics | Análisis |
| MSFlags | MSACFlags | Marcas |
| MSFlagsNormal | MSACFlagsNormal | Flags.normal |
| MSFlagsCritical | MSACFlagsCritical | .Crítico |
| MSFlagsDefault | MSACFlagsDefault | .Predeterminado |
| MSEventProperties | MSACEventProperties | EventProperties |
App Center se bloquea más abajo 4.0.0 |
Bloqueos de 4.0.0App Center + (ObjC) |
Bloqueos 4.0.0de App Center + (Swift) |
|---|---|---|
| MSCrashes | MSACCrashes | Bloqueos |
| MSCrashesDelegate | MSACCrashesDelegate | CrashesDelegate |
| MSErrorReport | MSACErrorReport | ErrorReport |
| MSErrorAttachmentLog | MSACErrorAttachmentLog | ErrorAttachmentLog |
| MSUserConfirmationDontSend | MSACUserConfirmationDontSend | UserConfirmation.dontSend |
| MSUserConfirmationSend | MSACUserConfirmationSend | .Enviar |
| MSUserConfirmationAlways | MSACUserConfirmationAlways | .Siempre |
| MSUserConfirmationHandler | MSACUserConfirmationHandler | UserConfirmationHandler |
Distribución inferior de App Center 4.0.0 |
App Center Distribute 4.0.0+ (ObjC) |
App Center Distribute 4.0.0+ (Swift) |
|---|---|---|
| MSDistribute | MSACDistribute | Distribución |
| MSDistributeDelegate | MSACDistributeDelegate | DistributeDelegate |
| MSCrashHandlerSetupDelegate | MSACCrashHandlerSetupDelegate | CrashHandlerSetupDelegate |
| MSReleaseDetails | MSACReleaseDetails | ReleaseDetails |
| MSUpdateAction | MSACUpdateAction | UpdateAction |
| MSUpdateActionUpdate | MSACUpdateActionUpdate | UpdateAction.update |
| MSUpdateActionPostpone | MSACUpdateActionPostpone | .Posponer |
| MSUpdateTrack | MSACUpdateTrack | UpdateTrack |
| MSUpdateTrackPublic | MSACUpdateTrackPublic | UpdateTrack.public |
| MSUpdateTrackPrivate | MSACUpdateTrackPrivate | .Privado |
Cambios en la API de Swift
App Center Core inferior 4.0.0 |
App Center Core 4.0.0+ |
|---|---|
| MSAppCenter.isEnabled() | AppCenter.enabled |
| 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.isAppSecretRequired |
| 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 App Center inferior 4.0.0 |
Análisis de App Center 4.0.0+ |
|---|---|
| MSAnalytics.isEnabled() | Analytics.enabled |
| MSAnalytics.setEnabled(true) | Analytics.enabled = true |
| MSAnalytics.setTransmissionInterval(600) | Analytics.transmissionInterval = 600 |
App Center se bloquea más abajo 4.0.0 |
Bloqueos de App Center 4.0.0+ |
|---|---|
| MSCrashes.isEnabled() | Crashes.enabled |
| MSCrashes.setEnabled(true) | Crashes.enabled = true |
| MSCrashes.setDelegate(delegate) | Crashes.delegate = delegado |
| 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 |
Distribución de App Center inferior 4.0.0 |
Distribución de App Center 4.0.0+ |
|---|---|
| MSDistribute.isEnabled() | Distribute.enabled |
| MSDistribute.setEnabled(true) | Distribute.enabled = true |
| MSDistribute.setDelegate(delegate) | Distribute.delegate = delegate |
| MSDistribute.setApiUrl("{API URL}") | Distribute.apiUrl = "{API URL}" |
| MSDistribute.setInstallUrl("{Install URL}") | Distribute.installUrl = "{Instal URL}" |
| MSDistribute.isMandatoryUpdate | Distribute.mandatoryUpdate |
CrashesDelegate changes
Antes de actualizar el SDK de App Center a y versiones 4.0.0 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 y versiones 4.0.0 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 de DistributeDelegate
Antes de actualizar el SDK de App Center a y versiones 4.0.0 posteriores.
func distribute(_ distribute: MSDistribute!, releaseAvailableWith details: MSReleaseDetails!) -> Bool
Después de actualizar el SDK de App Center a y versiones 4.0.0 posteriores.
func distribute(_ distribute: Distribute, releaseAvailableWith details: ReleaseDetails) -> Bool