Поделиться через

Перейдите на App Center SDK версии 4.0.0 или более поздние версии

Это важно

Центр приложений Visual Studio был прекращен 31 марта 2025 г., за исключением функций аналитики и диагностики, которые будут поддерживаться до 30 июня 2026 г. Подробнее.

Чтобы избежать конфликта имен с классами в приватных фреймворках Apple, SDK теперь использует префикс MSAC вместо MS, что изменяет API SDK.

API Swift теперь имеет более быстрый стиль, и все классы должны использоваться без префикса, например AppCenter. Также изменены принципы именования функций и свойств в соответствии с лучшими практиками Apple Swift.

Обновление пакета SDK центра приложений

Сначала обновите пакет SDK Центра приложений с помощью одного из диспетчеров зависимостей.

Использование API

Самый быстрый и удобный способ обновления API App Center SDK — использовать функцию автокоррекции. После замены вы должны получить результат, как показано ниже.

Перед обновлением пакета SDK Центра приложений до 4.0.0 и выше.

[MSAppCenter start:@"{Your App Secret}" withServices:@[[MSAnalytics class], [MSCrashes class]]];

MSAppCenter.start("{Your App Secret}", withServices: [MSAnalytics.self, MSCrashes.self])

После обновления пакета SDK центра приложений до 4.0.0 и более поздней версии.

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

Кроме того, getter [MSACWrapperCrashesHelper getCrashHandlerSetupDelegate] теперь устарел, используйте [MSACWrapperCrashesHelper crashHandlerSetupDelegate] вместо него.

В следующих таблицах показаны API, которые были переименованы.

Ядро Центра приложений ниже 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 .предупреждение
MSLogLevelInfo MSACLogLevelInfo .информация
MSLogLevelAssert MSACLogLevelAssert .assert
MSLogHandler MSACLogHandler LogHandler
MSLogMessageProvider MSACLogMessageProvider LogMessageProvider
Аналитика Центра приложений ниже 4.0.0 Аналитика 4.0.0Центра приложений + (ObjC) Центр приложений Alanlytics 4.0.0+ (Swift)
MSAnalytics MSACAnalytics Аналитика
MSFlags MSACFlags Флаги
MSFlagsNormal MSACFlagsNormal Флаги.нормальный
MSFlagsCritical MSACFlagsCritical .критический
MSFlagsDefault MSACFlagsDefault .по умолчанию
MSEventProperties MSACEventProperties EventProperties
Сбои Центра приложений ниже 4.0.0 Сбои Центра приложений 4.0.0+ (ObjC) Сбои в Центре приложений 4.0.0+ (Swift)
MSCrashes MSACCrashes Сбои
MSCrashesDelegate MSACCrashesDelegate Аварийное завершениеDelegate
Сообщение об ошибке MS MSACErrorReport Отчет об ошибке
MSErrorAttachmentLog MSACErrorAttachmentLog Журнал вложений ошибок
Пользовательское подтверждение: Не отправлять MSACUserConfirmationDontSend ПодтверждениеПользователя.неОтправлять
MSUserConfirmationSend ОтправитьПодтверждениеПользователяMSAC .Отправить
MSUserConfirmationAlways MSACUserConfirmationAlways .всегда
MSUserConfirmationHandler MSACUserConfirmationHandler ОбработчикПодтвержденияПользователя
Распределение в Центре приложений ниже 4.0.0 Распространение 4.0.0в Центре приложений + (ObjC) Распространение 4.0.0в Центре приложений + (Swift)
MSDistribute MSACDistribute Распространение
MSDistributeDelegate MSACDistributeDelegate РаспределитьДелегат
MSCrashHandlerSetupDelegate MSACCrashHandlerSetupDelegate CrashHandlerSetupDelegate
MSReleaseDetails МСАКДеталиРелиза Детали выпуска
MSUpdateAction MSACUpdateAction UpdateAction
ОбновлениеMSДействиеОбновления MSACUpdateActionUpdate UpdateAction.update
MSUpdateActionОтложить Действие обновления MSAC отложить .отложить
MSUpdateTrack MSACUpdateTrack (отслеживание обновлений MSAC) UpdateTrack
MSUpdateTrackPublic MSACUpdateTrackPublic UpdateTrack.public
MSUpdateTrackPrivate MSACUpdateTrackPrivate .private

Изменения API Swift

Ядро Центра приложений ниже 4.0.0 Ядро Центра приложений 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 = "{URL журнала}"
MSAppCenter.setLogLevel(.verbose) AppCenter.logLevel = .verbose
MSAppCenter.setLogHandler(logHandler) AppCenter.logHandler = logHandler
MSAppCenter.SetUserId("{идентификатор пользователя}") AppCenter.userId = "{User Id}"
MSAppCenter.setCountryCode("{Country Code}") AppCenter.countryCode = "{Код страны}"
MSAppCenter.setAppSecret("{App Secret}") AppCenter.appSecret = "{App Secret}"
MSAppCenter.setString("value", forKey: "key") AppCenter.setString("value", for: "key")
MSServiceAbstract.isAppSecretRequired() ServiceAbstract.необходимAppSecret
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}", службы: [Analytics.self])
MSAppCenter.startWithServices([MSAnalytics.self, MSCrashes.self]) AppCenter.start(services: [Analytics.self, Crashes.self])
MSAppCenter.startFromLibraryWithServices([MSAnalytics.self]) AppCenter.startFromLibrary(services: [Analytics.self]) ")
Аналитика Центра приложений ниже 4.0.0 Аналитика Центра приложений 4.0.0+
MSAnalytics.isEnabled() Аналитика включена
MSAnalytics.setEnabled(true) Analytics.enabled = true // Аналитика включена
MSAnalytics.setTransmissionInterval(600) Analytics.transmissionInterval = 600
Сбои Центра приложений ниже 4.0.0 Сбои Центра приложений 4.0.0+
MSCrashes.isEnabled() Сбои.включены
MSCrashes.setEnabled(true) Crashes.включено = true
MSCrashes.setDelegate(делегат) Crashes.delegate = делегат
MSCrashes.hasCrashedInLastSession() Аварии.допущеноАварииВПоследнейСессии
MSCrashes.hasReceivedMemoryWarningInLastSession() Сбои.ПолученоПредупреждениеОПамятиВПоследнейСессии
MSErrorReport.isAppKill() ErrorReport.isAppKill
MSCrashes.lastSessionCrashReport() Crashes.lastSessionCrashReport
MSCrashes.setAutomaticProcessing(true) Crashes.автоматическаяОбработка = true
MSWrapperCrashesHelper.getCrashHandlerSetupDelegate ОберткаCrashesHelper.crashHandlerSetupDelegate
MSWrapperCrashesHelper.setCrashHandlerSetupDelegate(делегат) WrapperCrashesHelper.crashHandlerSetupDelegate = делегат
MSCrashes.setUserConfirmationHandler(handler) Crashes.userConfirmationHandler = обработчик
Распределение в Центре приложений ниже 4.0.0 Распространение в Центре приложений 4.0.0+
MSDistribute.isEnabled() Функция распространения включена
MSDistribute.setEnabled(true) Distribute.enabled = true
MSDistribute.setDelegate(делегат) Distribute.delegate = делегат
MSDistribute.setApiUrl("{URL-адрес API}") Distribute.apiUrl = "{API URL}"
MSDistribute.setInstallUrl("{Install URL}") Distribute.installUrl = "{Instal URL}"
MSDistribute.isMandatoryUpdate Обязательное обновление распределения

Изменения делегата аварийного завершения

Перед обновлением пакета SDK Центра приложений до 4.0.0 и выше.

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]

После обновления App Center SDK до 4.0.0 и выше.

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]

Изменения делегирования

Перед обновлением пакета SDK Центра приложений до 4.0.0 и выше.

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

После обновления пакета SDK центра приложений до 4.0.0 и более поздней версии.

  func distribute(_ distribute: Distribute, releaseAvailableWith details: ReleaseDetails) -> Bool