Переход на пакет SDK центра приложений версии 4.0.0 и более поздних версий
Важно!
Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio до полного прекращения его использования, существует несколько рекомендуемых вариантов, на которые можно перейти.
Узнайте больше о сроках поддержки и альтернативных вариантах.
Чтобы избежать конфликта именования с классами в частных платформах Apple, пакет SDK теперь использует MSAC префикс, который MS изменяет API пакета SDK.
Api Swift теперь имеет более быстрый стиль, и все классы должны использоваться без префикса, например AppCenter. Также внесены изменения в именование функций и свойств на основе рекомендаций Apple Swift.
Обновление пакета SDK для Центра приложений
Сначала обновите пакет SDK центра приложений с помощью одного из диспетчеров зависимостей.
Использование API
Самый быстрый и удобный способ обновления API пакета 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])
Кроме того, метод получения [MSACWrapperCrashesHelper getCrashHandlerSetupDelegate] теперь является нерекомендуемой. Вместо этого используйте [MSACWrapperCrashesHelper crashHandlerSetupDelegate] .
В следующих таблицах показаны переименованные API.
Ядро Центра приложений ниже 4.0.0 |
Центр приложений Core 4.0.0+ (ObjC) |
Центр приложений Core 4.0.0+ (Swift) |
|---|---|---|
| MSAppCenter | MSACAppCenter | Центр приложений |
| MSLogLevel | MSACLogLevel | LogLevel |
| MSLogLevelVerbose | MSACLogLevelVerbose | LogLevel.verbose |
| MSLogLevelWarning | MSACLogLevelWarning | .Предупреждение |
| MSLogLevelInfo | MSACLogLevelInfo | .Информация |
| MSLogLevelAssert | MSACLogLevelAssert | .Утверждать |
| MSLogHandler | MSACLogHandler | LogHandler |
| MSLogMessageProvider | MSACLogMessageProvider | LogMessageProvider |
Аналитика центра приложений ниже 4.0.0 |
Аналитика Центра приложений 4.0.0+ (ObjC) |
Центр приложений Alanlytics 4.0.0+ (Swift) |
|---|---|---|
| MSAnalytics | MSACAnalytics | Аналитика |
| MSFlags | MSACFlags | Флаги |
| MSFlagsNormal | MSACFlagsNormal | Flags.normal |
| MSFlagsCritical | MSACFlagsCritical | .Критических |
| MSFlagsDefault | MSACFlagsDefault | .По умолчанию |
| MSEventProperties | MSACEventProperties | EventProperties |
Сбои центра приложений ниже 4.0.0 |
Сбои центра приложений 4.0.0+ (ObjC) |
Сбои центра приложений 4.0.0+ (Swift) |
|---|---|---|
| MSCrashes | MSACCrashes | Сбои |
| MSCrashesDelegate | MSACCrashesDelegate | CrashesDelegate |
| MSErrorReport | MSACErrorReport | ErrorReport |
| MSErrorAttachmentLog | MSACErrorAttachmentLog | ErrorAttachmentLog |
| MSUserConfirmationDontSend | MSACUserConfirmationDontSend | UserConfirmation.dontSend |
| MSUserConfirmationSend | MSACUserConfirmationSend | .Отправить |
| MSUserConfirmationAlways | MSACUserConfirmationAlways | .Всегда |
| MSUserConfirmationHandler | MSACUserConfirmationHandler | UserConfirmationHandler |
Распространение в Центре приложений ниже 4.0.0 |
Распространение 4.0.0в Центре приложений + (ObjC) |
Распространение 4.0.0+ (Swift) в Центре приложений |
|---|---|---|
| MSDistribute | MSACDistribute | Распространение |
| MSDistributeDelegate | MSACDistributeDelegate | DistributeDelegate |
| MSCrashHandlerSetupDelegate | MSACCrashHandlerSetupDelegate | CrashHandlerSetupDelegate |
| MSReleaseDetails | MSACReleaseDetails | ReleaseDetails |
| MSUpdateAction | MSACUpdateAction | UpdateAction |
| MSUpdateActionUpdate | MSACUpdateActionUpdate | UpdateAction.update |
| MSUpdateActionPostpone | MSACUpdateActionPostpone | .Отложить |
| MSUpdateTrack | MSACUpdateTrack | UpdateTrack |
| MSUpdateTrackPublic | MSACUpdateTrackPublic | UpdateTrack.public |
| MSUpdateTrackPrivate | MSACUpdateTrackPrivate | .Частная |
Изменения в API Swift
Ниже центр приложений Core 4.0.0 |
Центр приложений Core 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-адрес журнала}") | AppCenter.logUrl = "{URL-адрес журнала}" |
| MSAppCenter.setLogLevel(.verbose) | AppCenter.logLevel = .verbose |
| MSAppCenter.setLogHandler(logHandler) | AppCenter.logHandler = logHandler |
| MSAppCenter.SetUserId("{User Id}") | AppCenter.userId = "{Идентификатор пользователя}" |
| MSAppCenter.setCountryCode("{Код страны}") | AppCenter.countryCode = "{Код страны}" |
| MSAppCenter.setAppSecret("{Секрет приложения}") | AppCenter.appSecret = "{Секрет приложения}" |
| MSAppCenter.setString("value", forKey: "key") | AppCenter.setString("value", for: "key") |
| MSServiceAbstract.isAppSecretRequired() | ServiceAbstract.isAppSecretRequired |
| MSAppCenter.addChannelUnitWithConfiguration(configuration) | AppCenter.addChannelUnit(withConfiguration:configuration) |
| MSAppCenter.configureWithAppSecret("{Секрет приложения}") | AppCenter.configure(withAppSecret:"{Секрет приложения}") |
| MSAppCenter.start("{Секрет приложения}", withServices: [MSAnalytics.self]) | AppCenter.start(withAppSecret: "{Секрет приложения}", службы: [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() | Analytics.enabled |
| MSAnalytics.setEnabled(true) | Analytics.enabled = true |
| MSAnalytics.setTransmissionInterval(600) | Analytics.transmissionInterval = 600 |
Сбои центра приложений ниже 4.0.0 |
Сбои центра приложений 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 = handler |
Распространение в Центре приложений ниже 4.0.0 |
Распространение в Центре приложений 4.0.0+ |
|---|---|
| MSDistribute.isEnabled() | Распространение.enabled |
| MSDistribute.setEnabled(true) | Distribute.enabled = true |
| MSDistribute.setDelegate(delegate) | Distribute.delegate = delegate |
| MSDistribute.setApiUrl("{API URL}") | Distribute.apiUrl = "{API URL}" |
| MSDistribute.setInstallUrl("{URL-адрес установки}") | Distribute.installUrl = "{URL-адрес установки}" |
| MSDistribute.isMandatoryUpdate | Distribute.mandatoryUpdate |
Изменения crashesDelegate
Перед обновлением пакета 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]
После обновления пакета 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]
Изменения DistributeDelegate
Перед обновлением пакета SDK центра приложений до 4.0.0 и более поздней версии.
func distribute(_ distribute: MSDistribute!, releaseAvailableWith details: MSReleaseDetails!) -> Bool
После обновления пакета SDK центра приложений до 4.0.0 и более поздних версий.
func distribute(_ distribute: Distribute, releaseAvailableWith details: ReleaseDetails) -> Bool