Migrar para o SDK do App Center 4.0.0 e superior
Importante
O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar a migração.
Para evitar um conflito de nomenclatura com classes nas estruturas privadas da Apple, o SDK agora usa MSAC o prefixo em vez de MS alterar a API do SDK.
A API Swift agora tem um estilo mais rápido e todas as classes devem ser usadas sem um prefixo, por exemplo, AppCenter. Também há alterações na nomenclatura de funções e propriedades com base nas práticas recomendadas do Apple Swift.
Atualizar o SDK do App Center
Primeiro, atualize o SDK do App Center usando um dos gerenciador de dependências.
Uso de APIs
A maneira mais rápida e conveniente de atualizar a API do SDK do App Center é usar a correção automática. Após a substituição, você deve obter o resultado, conforme mostrado abaixo.
Antes de atualizar o SDK do App Center para 4.0.0 e superior.
[MSAppCenter start:@"{Your App Secret}" withServices:@[[MSAnalytics class], [MSCrashes class]]];
MSAppCenter.start("{Your App Secret}", withServices: [MSAnalytics.self, MSCrashes.self])
Depois de atualizar o SDK do App Center para 4.0.0 e superior.
[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];
AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])
Além disso, o getter [MSACWrapperCrashesHelper getCrashHandlerSetupDelegate] agora está preterido, use [MSACWrapperCrashesHelper crashHandlerSetupDelegate] em vez disso.
As tabelas a seguir mostram as APIs que foram renomeadas.
Núcleo do App Center inferior 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 | .Aviso |
| MSLogLevelInfo | MSACLogLevelInfo | .Informação |
| MSLogLevelAssert | MSACLogLevelAssert | .Assert |
| MSLogHandler | MSACLogHandler | LogHandler |
| MSLogMessageProvider | MSACLogMessageProvider | LogMessageProvider |
Análise do App Center mais baixa 4.0.0 |
Análise do 4.0.0App Center + (ObjC) |
Alanlytics 4.0.0+ (Swift) do App Center |
|---|---|---|
| MSAnalytics | MSACAnalytics | Análise |
| MSFlags | MSACFlags | Flags |
| MSFlagsNormal | MSACFlagsNormal | Flags.normal |
| MSFlagsCritical | MSACFlagsCritical | .Crítico |
| MSFlagsDefault | MSACFlagsDefault | .Padrão |
| MSEventProperties | MSACEventProperties | EventProperties |
Falhas no App Center mais baixo 4.0.0 |
Falhas 4.0.0do App Center + (ObjC) |
Falhas 4.0.0do App Center + (Swift) |
|---|---|---|
| MSCrashes | MSACCrashes | Falhas |
| MSCrashesDelegate | MSACCrashesDelegate | CrashesDelegate |
| MSErrorReport | MSACErrorReport | ErrorReport |
| MSErrorAttachmentLog | MSACErrorAttachmentLog | ErrorAttachmentLog |
| MSUserConfirmationDontSend | MSACUserConfirmationDontSend | UserConfirmation.dontSend |
| MSUserConfirmationSend | MSACUserConfirmationSend | .Enviar |
| MSUserConfirmationAlways | MSACUserConfirmationAlways | .Sempre |
| MSUserConfirmationHandler | MSACUserConfirmationHandler | UserConfirmationHandler |
Distribuição inferior do App Center 4.0.0 |
Distribuição 4.0.0do App Center + (ObjC) |
Distribuição do 4.0.0App Center + (Swift) |
|---|---|---|
| MSDistribute | MSACDistribute | Distribuir |
| MSDistributeDelegate | MSACDistributeDelegate | DistributedDelegate |
| MSCrashHandlerSetupDelegate | MSACCrashHandlerSetupDelegate | CrashHandlerSetupDelegate |
| MSReleaseDetails | MSACReleaseDetails | ReleaseDetails |
| MSUpdateAction | MSACUpdateAction | UpdateAction |
| MSUpdateActionUpdate | MSACUpdateActionUpdate | UpdateAction.update |
| MSUpdateActionPostpone | MSACUpdateActionPostpone | .Adiar |
| MSUpdateTrack | MSACUpdateTrack | UpdateTrack |
| MSUpdateTrackPublic | MSACUpdateTrackPublic | UpdateTrack.public |
| MSUpdateTrackPrivate | MSACUpdateTrackPrivate | .Privada |
Alterações rápidas na API
Núcleo do App Center inferior 4.0.0 |
Núcleo do App Center 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("{Url de Log}") | AppCenter.logUrl = "{Url de Log}" |
| MSAppCenter.setLogLevel(.verbose) | AppCenter.logLevel = .verbose |
| MSAppCenter.setLogHandler(logHandler) | AppCenter.logHandler = logHandler |
| MSAppCenter.SetUserId("{Id de usuário}") | AppCenter.userId = "{Id de usuário}" |
| MSAppCenter.setCountryCode("{Country Code}") | AppCenter.countryCode = "{Country Code}" |
| MSAppCenter.setAppSecret("{Segredo do Aplicativo}") | AppCenter.appSecret = "{Segredo do Aplicativo}" |
| 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("{Segredo do Aplicativo}", comServices: [MSAnalytics.self]) | AppCenter.start(withAppSecret: "{App Secret}", serviços: [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álise do App Center mais baixa 4.0.0 |
Análise do App Center 4.0.0+ |
|---|---|
| MSAnalytics.isEnabled() | Analytics.enabled |
| MSAnalytics.setEnabled(true) | Analytics.enabled = true |
| MSAnalytics.setTransmissionInterval(600) | Analytics.transmissionInterval = 600 |
Falhas no App Center mais baixo 4.0.0 |
Falhas no 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 = manipulador |
Distribuição inferior do App Center 4.0.0 |
Distribuição do 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 = "{Instalar URL}" |
| MSDistribute.isMandatoryUpdate | Distribute.mandatoryUpdate |
FalhasDelegar alterações
Antes de atualizar o SDK do App Center para 4.0.0 e superior.
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]
Depois de atualizar o SDK do App Center para 4.0.0 e superior.
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]
Alterações de DistributeDelegate
Antes de atualizar o SDK do App Center para 4.0.0 e superior.
func distribute(_ distribute: MSDistribute!, releaseAvailableWith details: MSReleaseDetails!) -> Bool
Depois de atualizar o SDK do App Center para 4.0.0 e superior.
func distribute(_ distribute: Distribute, releaseAvailableWith details: ReleaseDetails) -> Bool