App Center SDK 4.0.0 以降に移行する
重要
Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。
Apple のプライベート フレームワーク内のクラスとの名前付けの競合を回避するために、SDK は SDK API を変更する代わりにMSプレフィックスを使用MSACするようになりました。
Swift API は、より迅速なスタイルになりました。すべてのクラスをプレフィックスなしで使用する必要があります (例: )。 AppCenter Apple Swift のベスト プラクティスに基づく関数とプロパティの名前付けにも変更があります。
App Center SDK を更新する
まず、いずれかの依存関係マネージャーを使用して App Center SDK を更新します。
API の使用
App Center SDK API を更新する最も高速で最も便利な方法は、オートコレクトを使用することです。 置換後、次に示すように結果が得られます。
App Center SDK を以降に更新する 4.0.0 前に。
[MSAppCenter start:@"{Your App Secret}" withServices:@[[MSAnalytics class], [MSCrashes class]]];
MSAppCenter.start("{Your App Secret}", withServices: [MSAnalytics.self, MSCrashes.self])
App Center 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 を示します。
App Center Core の下位 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 | 。アサート |
| MSLogHandler | MSACLogHandler | LogHandler |
| MSLogMessageProvider | MSACLogMessageProvider | LogMessageProvider |
App Center Analytics を低くする 4.0.0 |
App Center Analytics 4.0.0+ (ObjC) |
App Center Alanlytics 4.0.0+ (Swift) |
|---|---|---|
| MSAnalytics | MSACAnalytics | 分析 |
| MSFlags | MSACFlags | Flags |
| MSFlagsNormal | MSACFlagsNormal | Flags.normal |
| MSFlagsCritical | MSACFlagsCritical | 。重要 |
| MSFlagsDefault | MSACFlagsDefault | 。既定 |
| MSEventProperties | MSACEventProperties | EventProperties |
App Center のクラッシュが低い 4.0.0 |
App Center の 4.0.0クラッシュ + (ObjC) |
App Center の 4.0.0クラッシュ + (Swift) |
|---|---|---|
| MSCrashes | MSACCrashes | Crashes |
| MSCrashesDelegate | MSACCrashesDelegate | CrashesDelegate |
| MSErrorReport | MSACErrorReport | ErrorReport |
| MSErrorAttachmentLog | MSACErrorAttachmentLog | ErrorAttachmentLog |
| MSUserConfirmationDontSend | MSACUserConfirmationDontSend | UserConfirmation.dontSend |
| MSUserConfirmationSend | MSACUserConfirmationSend | 。送信 |
| MSUserConfirmationAlways | MSACUserConfirmationAlways | 。いつも |
| MSUserConfirmationHandler | MSACUserConfirmationHandler | UserConfirmationHandler |
App Center の配布を低くする 4.0.0 |
App Center Distribute 4.0.0+ (ObjC) |
App Center の配布 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 | 。プライベート |
Swift API の変更
App Center Core の下位 4.0.0 |
App Center 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("{Log Url}") | AppCenter.logUrl = "{Log Url}" |
| MSAppCenter.setLogLevel(.verbose) | AppCenter.logLevel = .verbose |
| MSAppCenter.setLogHandler(logHandler) | AppCenter.logHandler = logHandler |
| MSAppCenter.SetUserId("{User Id}") | AppCenter.userId = "{User Id}" |
| MSAppCenter.setCountryCode("{Country Code}") | AppCenter.countryCode = "{Country Code}" |
| MSAppCenter.setAppSecret("{App Secret}") | AppCenter.appSecret = "{App Secret}" |
| MSAppCenter.setString("value", forKey: "key") | AppCenter.setString("value", for: "key") |
| MSServiceAbstract.isAppSecretRequired() | ServiceAbstract.isAppSecretRequired |
| 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}", services: [Analytics.self]) |
| MSAppCenter.startWithServices([MSAnalytics.self, MSCrashes.self]) | AppCenter.start(services: [Analytics.self, Crashes.self]) |
| MSAppCenter.startFromLibraryWithServices([MSAnalytics.self]) | AppCenter.startFromLibrary(services: [Analytics.self]) ") |
App Center Analytics を低くする 4.0.0 |
App Center Analytics 4.0.0+ |
|---|---|
| MSAnalytics.isEnabled() | Analytics.enabled |
| MSAnalytics.setEnabled(true) | Analytics.enabled = true |
| MSAnalytics.setTransmissionInterval(600) | Analytics.transmissionInterval = 600 |
App Center のクラッシュが低い 4.0.0 |
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 = handler |
App Center の配布を低くする 4.0.0 |
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 = "{Instal URL}" |
| MSDistribute.isMandatoryUpdate | Distribute.mandatoryUpdate |
CrashesDelegate の変更
App Center 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]
DistributeDelegate の変更
App Center SDK を以降に更新する 4.0.0 前に。
func distribute(_ distribute: MSDistribute!, releaseAvailableWith details: MSReleaseDetails!) -> Bool
App Center SDK を 以降に 4.0.0 更新した後。
func distribute(_ distribute: Distribute, releaseAvailableWith details: ReleaseDetails) -> Bool