Compartilhar via

Migrar para o SDK do App Center 4.0.0 e superior

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, com exceção dos recursos de Análise e Diagnóstico, que continuarão com suporte até 30 de junho de 2026. Saiba mais.

Para evitar um conflito de nomenclatura com classes nas estruturas privadas da Apple, o SDK agora usa o prefixo MSAC em vez de MS, o que modifica 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 gerentes de dependência.

Uso de APIs

A maneira mais rápida e conveniente de atualizar a API do SDK do App Center é usar a autocorreção. Após a substituição, você deverá obter o resultado, conforme mostrado abaixo.

Antes de atualizar o SDK do App Center para 4.0.0 e versões superiores.

[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 versões posteriores.

[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 .info
MSLogLevelAssert MSACLogLevelAssert .afirmar
MSLogHandler MSACLogHandler LogHandler
MSLogMessageProvider MSACLogMessageProvider LogMessageProvider
Análise do App Center em nível mais baixo 4.0.0 Análise do 4.0.0App Center + (ObjC) Centro de Aplicativos Alanlytics 4.0.0+ (Swift)
MSAnalytics MSACAnalytics Análises de dados
MSFlags MSACFlags Sinalizadores
MSFlagsNormal MSACFlagsNormal Bandeiras.normal
MSFlagsCritical MSACFlagsCritical .crítico
MSFlagsDefault MSACFlagsDefault .padrão
MSEventProperties MSACEventProperties EventProperties
Falhas no App Center são mais baixas 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 Relatório de Erros
MSErrorAttachmentLog MSACErrorAttachmentLog Log de Anexo de Erro
ConfirmacaoUsuarioNaoEnviar ConfirmaçãoDoUsuárioMSACNãoEnviar UserConfirmation.naoEnviar
MSUserConfirmationSend MSACUserConfirmationSend .Enviar
MSUserConfirmationAlways MSACUserConfirmationAlways .sempre
MSUserConfirmationHandler (ManipuladorDeConfirmaçãoDeUsuárioMS) MSACUserConfirmationHandler ManipuladorDeConfirmaçãoDeUsuário
Distribuição inferior do App Center 4.0.0 Distribuição 4.0.0+ (ObjC) do App Center Distribuição do 4.0.0App Center + (Swift)
MSDistribute MSACDistribute Distribuir
MSDistributeDelegate MSACDistributeDelegate DistribuirDelegar
DelegadoDeConfiguraçãoDoManipuladorDeFalhasMS MSACCrashHandlerSetupDelegate CrashHandlerSetupDelegate
Detalhes da Liberação MS DetalhesDeLançamentoMSAC Detalhes da Lançamento
MSUpdateAction MSACUpdateAction UpdateAction
AçãoDeAtualizaçãoMS AçãoDeAtualizaçãoMSAC AçãoDeAtualização.atualizar
MSUpdateActionPostpone AçãoDeAtualizaçãoMSACPostergar .adiar
MSUpdateTrack MSACUpdateTrack UpdateTrack
MSUpdateTrackPublic MSACUpdateTrackPublic UpdateTrack.public
MSUpdateTrackPrivate MSACUpdateTrackPrivate .privado

Alterações de API Swift

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 // Ativar o AppCenter
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 registro}") 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 do 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) // Adiciona uma unidade de canal com configuração
MSAppCenter.configureWithAppSecret("{Segredo do Aplicativo}") AppCenter.configure(withAppSecret:"{App Secret}")
MSAppCenter.start("{Segredo do Aplicativo}", withServices: [MSAnalytics.self]) AppCenter.iniciar(comAppSecret: "{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 em nível mais baixo 4.0.0 Análise do App Center 4.0.0+
MSAnalytics.isEnabled() Analytics.enabled
MSAnalytics.setEnabled(true) Analytics.ativado = true
MSAnalytics.setTransmissionInterval(600) Analytics.transmissionInterval = 600
Falhas no App Center são mais baixas 4.0.0 Falhas no App Center 4.0.0+
MSCrashes.isEnabled() Crashes.ativado
MSCrashes.setEnabled(true) Crashes.enabled = true // Habilita falhas
MSCrashes.setDelegate(delegate) Crashes.delegate = delegate
MSCrashes.hasCrashedInLastSession() Erros.ocorreuErroNaÚltimaSessão
MSCrashes.recebeuAvisoDeMemóriaNaÚltimaSessão() Crashes.recebeuAvisoDeMemóriaNaÚltimaSessão
MSErrorReport.isAppKill() ErrorReport.isAppKill
MSCrashes.lastSessionCrashReport() RelatórioDeErroDaÚltimaSessão
MSCrashes.definirProcessamentoAutomático(true) Crashes.automaticProcessing = true
MSWrapperCrashesHelper.getCrashHandlerSetupDelegate WrapperCrashesHelper.crashHandlerSetupDelegate
MSWrapperCrashesHelper.setCrashHandlerSetupDelegate(delegate) WrapperCrashesHelper.crashHandlerSetupDelegate = delegado
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("{URL da API}") Distribute.apiUrl = "{API URL}"
MSDistribute.setInstallUrl("{Install URL}") Distribute.installUrl = "{Instal URL}"
MSDistribute.isMandatoryUpdate Distribute.atualizacaoObrigatoria

Alterações do CrashesDelegate

Antes de atualizar o SDK do App Center para 4.0.0 e versões superiores.

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 versões 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]

Mudanças de DistributeDelegate

Antes de atualizar o SDK do App Center para 4.0.0 e versões superiores.

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

Depois de atualizar o SDK do App Center para 4.0.0 e versões posteriores.

  func distribute(_ distribute: Distribute, releaseAvailableWith details: ReleaseDetails) -> Bool
  • Last updated on