Partilhar via


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.

Saiba mais sobre linhas do tempo e alternativas de suporte.

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