Partilhar via

Migrar para o App Center SDK 4.0.0 e superior

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, exceto para os recursos de Análise e Diagnóstico, que continuarão a ter suporte até 30 de junho de 2026. Mais informações.

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 altera a API do SDK.

Swift API tem agora um estilo mais rápido, e todas as classes devem ser usadas sem um prefixo, por exemplo. AppCenter Há também alterações na nomenclatura de funções e propriedades com base nas melhores práticas do Apple Swift.

Atualizar o SDK do App Center

Primeiro, atualize o SDK do App Center usando um dos gerenciadores de dependência.

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 como 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á obsoleto, por favor, use [MSACWrapperCrashesHelper crashHandlerSetupDelegate] em vez disso.

As tabelas a seguir mostram as APIs que foram renomeadas.

App Center Core inferior 4.0.0 App Center Core 4.0.0+ (ObjC) App Center Core 4.0.0+ (Swift)
MSAppCenter MSACAppCenter Centro de Aplicações
MSLogLevel MSACLogLevel LogLevel
MSLogLevelVerbose MSACLogLevelVerbose LogLevel.verbose
MSLogLevelWarning MSACLogLevelWarning .advertência
MSLogLevelInfo MSACLogLevelInfo .info
MSLogLevelAssert MSACLogLevelAssert .afirmar
MSLogHandler MSACLogHandler LogHandler
MSLogMessageProvider MSACLogMessageProvider LogMessageProvider
App Center Analytics mais baixo 4.0.0 Análises do Centro de Aplicações 4.0.0+ (ObjC) App Center Analytics 4.0.0+ (Swift)
MSAnalytics MSACAnálises Análises de Dados
MSFlags MSACFlags Bandeiras
MSFlagsNormal MSACFlagsNormal Bandeiras.normal
MSFlagsCritical MSACFlagsCritical .crítico
MSFlagsDefault MSACFlagsDefault .default
MSEventProperties MSACEventProperties EventProperties
App Center tem menos falhas 4.0.0 App Center falha 4.0.0+ (ObjC) App Center Falhas 4.0.0+ (Swift)
MSCrashes MSACCrashes Falhas
MSCrashesDelegate MSACCrashesDelegate DelegadoDeFalhas
Relatório de Erros MS MSACErrorReport Relatório de erros
MSErrorAttachmentLog MSACErrorAttachmentLog ErroAnexoLog
MSConfirmaçãoUtilizadorNãoEnviar MSACUserConfirmationNãoEnviar UserConfirmation.nãoEnviar
MSUserConfirmationEnviar MSACUserConfirmationEnviar .Enviar
MSUserConfirmationAlways MSACUserConfirmationAlways .sempre
MSUserConfirmationHandler MSACUserConfirmationHandler UserConfirmationHandler
App Center Distribuir mais baixo 4.0.0 App Center Distribuição 4.0.0+ (ObjC) App Center Distribuição 4.0.0+ (Swift)
MSDistribute MSACDistribute Distribuir
MSDistributeDelegate MSACDistributeDelegate DistributeDelegate
MSCrashHandlerSetupDelegate MSACCrashHandlerSetupDelegate CrashHandlerSetupDelegate
Detalhes da Liberação MS DetalhesDoLançamentoMSAC Detalhes do Lançamento
MSUpdateAction AçãoDeAtualizaçãoMSAC AçãoDeAtualização
Ação de Atualização MSUpdate MSACUpdateActionUpdate AçãoAtualização.atualizar
MSUpdateActionPostpone MSACUpdateActionPostpone .adiar
MSUpdateTrack MSACUpdateTrack UpdateTrack
MSUpdateTrackPublic MSACUpdateTrackPublic UpdateTrack.public
MSUpdateTrackPrivate MSACUpdateTrackPrivate .privado

Mudanças na API Swift

App Center Core inferior 4.0.0 Núcleo do App Center 4.0.0+
MSAppCenter.isEnabled() AppCenter.ativado
MSAppCenter.setEnabled(verdadeiro) AppCenter.enabled = verdadeiro
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 do usuário}") AppCenter.userId = "{ID do usuário}"
MSAppCenter.setCountryCode("{Código do País}") AppCenter.countryCode = "{Código do país}"
MSAppCenter.setAppSecret("{Segredo do aplicativo}") AppCenter.appSecret = "{Segredo do aplicativo}"
MSAppCenter.setString("value", forKey: "chave") AppCenter.setString("value", para: "chave")
MSServiceAbstract.isAppSecretRequired() ServiceAbstract.isAppSecretRequired
MSAppCenter.addChannelUnitWithConfiguration(configuração) AppCenter.adicionarUnidadeCanal(comConfiguração:configuração)
MSAppCenter.configureWithAppSecret("{Segredo do aplicativo}") AppCenter.configure(withAppSecret:"{Segredo do aplicativo}")
MSAppCenter.start("{App Secret}", comServiços: [MSAnalytics.self]) AppCenter.iniciar(comAppSecret: "{App Secret}", serviços: [Analytics.self])
MSAppCenter.startWithServices([MSAnalytics.self, MSCrashes.self]) AppCenter.start(serviços: [Analytics.self, Crashes.self])
MSAppCenter.startFromLibraryWithServices([MSAnalytics.self]) AppCenter.startFromLibrary(serviços: [Analytics.self]) ")
App Center Analytics mais baixo 4.0.0 Análise do App Center 4.0.0+
MSAnalytics.isEnabled() Análise.ativada
MSAnalytics.setEnabled(true) Analytics.enabled = verdadeiro
MSAnalytics.setTransmissionInterval(600) Analytics.transmissionInterval = 600
App Center tem menos falhas 4.0.0 O App Center falha 4.0.0+
MSCrashes.isEnabled() Crashes.ativado
MSCrashes.setEnabled(verdadeiro) Crashes.enabled = verdadeiro
MSCrashes.setDelegate(delegado) Crashes.delegate = delegado
A função "MSCrashes.hasCrashedInLastSession()" verifica se ocorreu uma falha na última sessão. Crashes.hasCrashedInLastSession
MSCrashes.recebeuAvisoDeMemóriaNaÚltimaSessão() Crashes.recebeuAvisoDeMemóriaNaÚltimaSessão
MSErrorReport.isAppKill() ErrorReport.isAppKill
MSCrashes.lastSessionCrashReport() Acidentes.lastSessionCrashReport
MSCrashes.setAutomaticProcessing(verdadeiro) Crashes.automaticProcessing = verdadeiro
MSWrapperCrashesHelper.getCrashHandlerSetupDelegate WrapperCrashesHelper.crashHandlerSetupDelegate
MSWrapperCrashesHelper.setCrashHandlerSetupDelegate(delegado) WrapperCrashesHelper.crashHandlerSetupDelegate = delegado
MSCrashes.setUserConfirmationHandler(tratador) Crashes.userConfirmationHandler = manipulador
App Center Distribuir mais baixo 4.0.0 App Center Distribuir 4.0.0+
MSDistribute.isEnabled() Distribute.enabled
MSDistribute.setEnabled(true) Distribute.enabled = verdadeiro
MSDistribute.setDelegate(delegado) Distribute.delegate = delegar
MSDistribute.setApiUrl("{URL da API}") Distribute.apiUrl = "{URL da API}"
MSDistribute.setInstallUrl("{URL de instalação}") Distribute.installUrl = "{Install URL}"
MSDistribute.isMandatoryUpdate (é uma Atualização Obrigatória) 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]

Mudanças no 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
  • Last updated on