Get Started with iOS

The App Center SDK uses a modular architecture so you can use any or all of the services.

You can find information about data collected by App Center on Data Collected by App Center SDKs, General Data Protection Regulation, and FAQ pages. Also, FAQ contains the answers, which you need to provide for App Store privacy configuration.

Let’s get started with setting up App Center iOS SDK in your app to use App Center Analytics and App Center Crashes. To add App Center Distribute to your app, look at the documentation for App Center Distribute.

1. Prerequisites

The following requirements must be met to use App Center SDK:

• Your iOS project is set up in Xcode 11 or later on macOS version 10.14.4 or later.
• You’re targeting devices running on iOS 9.0 or later.
• You’re not using any other library that provides Crash Reporting functionality (only for App Center Crashes).
• If you are using CocoaPods to integrate App Center, you need CocoaPods version 1.10 or later.

App Center SDK Analytics and Crashes are compatible with Mac Catalyst via XCFramework or SwiftPM.

2. Create your app in the App Center Portal to obtain the App Secret

If you’ve already created your app in the App Center portal, you can skip this step.

1. Head over to appcenter.ms.
2. Sign up or log in and hit the blue button on the top-right corner of the portal that says Add new and select Add new app from the dropdown menu.
3. Enter a name and an optional description for your app.
4. Select iOS as the OS and Objective-C/Swift as a platform.
5. Hit the button at the bottom right that says Add new app.

Once you’ve created an app, you can obtain its App Secret on the Settings page on the App Center Portal. At the top right-hand corner of the Settings page, click on the triple vertical dots and select Copy app secret to get your App Secret.

3. Add the App Center SDK modules

The App Center SDK for iOS can be added to your app via Cocoapods, Carthage, Swift Package Manager, or by manually adding the binaries to your project.

In the 4.0.0 version of App Center breaking changes were introduced. Follow the Migrate to App Center SDK 4.0.0 and higher section to migrate App Center from previous versions.

3.1 Integration via Cocoapods

ARM64 Simulators (when launched from Xcode running on Apple Silicon Mac) aren’t supported via CocoaPods, consider using other integration methods for it to work.

Add the following dependencies to your podfile to include App Center Analytics and App Center Crashes into your app. This action pulls in the following frameworks: AppCenter, AppCenterAnalytics, and AppCenterCrashes. Instead, you can specify services you want in your app. Each service has its own subspec and they all rely on AppCenter. It will get pulled in automatically.

Run pod install to install your newly defined pod and open the project’s .xcworkspace .

If you see an error like [!] Unable to find a specification for `AppCenter` while running pod install , run pod repo update to get the latest pods from the Cocoapods repository and then run pod install .

Now that you’ve integrated the frameworks in your application, it’s time to start the SDK and make use of the App Center services.

3.2 Integration via Carthage

Below are the steps on how to integrate the App Center SDK in your Xcode project using Carthage version 0.30 or higher, a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

Carthage integration doesn’t work out of box in Xcode 12. To make it work, refer to this Carthage instruction

Add the following dependencies to your Cartfile to include App Center. These dependencies pull in all the frameworks. Then you can link only those frameworks that you want to use in your app.

Run carthage update to fetch dependencies into a Carthage/Checkouts folder. Then build each framework.

Open your application target’s General settings tab. Drag and drop AppCenter.framework, AppCenterAnalytics.framework, and AppCenterCrashes.framework files from the Carthage/Build/iOS folder into Xcode’s Project Navigator. The AppCenter.framework is required to start the SDK. If it isn’t added to the project, the other modules won’t work and your app won’t compile.

A dialog will appear, make sure your app target is checked. Then click Finish.

If you use carthage copy-frameworks in your Build Phase you shouldn’t add the App Center SDKs there, as they’re shipped as static frameworks.

Now that you’ve integrated the frameworks in your application, it’s time to start the SDK and make use of the App Center services.

3.3 Integration via Swift Package Manager

1. From the Xcode menu click File > Swift Packages > Add Package Dependency.
2. In the dialog that appears, enter the repository URL: https://github.com/microsoft/appcenter-sdk-apple.git.
3. In Version, select Up to Next Major and take the default option.
4. Choose the modules you need in the Package Product column.

Now that you’ve integrated the frameworks in your application, it’s time to start the SDK and make use of the App Center services.

If you’re integrating App Center via SwiftPM and want to use it in your app’s extension target as well, make sure that you provide DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES in your configuration. This is necessary to avoid SwiftPM limitations in linking a module to multiple targets.

3.4 Integration by copying the binaries into your project

Below are the steps on how to integrate the compiled binaries in your Xcode project to set up App Center Analytics and App Center Crashes for your iOS app.

App Center SDK supports the use of XCframework . If you want to integrate XCframeworks into your project, download the AppCenter-SDK-Apple-XCFramework.zip from the releases page and unzip it. Resulting folder contents aren’t platform-specific, instead it contains XCframeworks for each module. They can be integrated the same way as usual frameworks, as described below.

Download the App Center SDK frameworks provided as a zip file.

Unzip the file and you’ll see a folder called AppCenter-SDK-Apple that contains different frameworks for each App Center service on each platform folder. The framework called AppCenter is required in the project as it contains code that’s shared between the different modules.

[Optional] Create a subdirectory for 3rd-party libraries.

• As a best practice, 3rd-party libraries are usually in a subdirectory, often called Vendor. If the project isn’t organized with a subdirectory for libraries, create a Vendor subdirectory now.
• Create a group called Vendor inside your Xcode project to mimic your file structure on disk.

Open the unzipped AppCenter-SDK-Apple folder in Finder and copy the folder into your project’s folder at the location where you want it. The folder contains frameworks in subfolders for other platforms that App Center SDK supports, so you might need to delete subfolders that you don’t need.

Add the SDK frameworks to the project in Xcode:

• Make sure the Project Navigator is visible (⌘+1).
• Now drag & drop AppCenter.framework, AppCenterAnalytics.framework, and AppCenterCrashes.framework from the Finder (in the location from the previous step) into Xcode’s Project Navigator. The AppCenter.framework is required to start the SDK. If it isn’t added to the project, the other modules won’t work and your app won’t compile.
• A dialog will appear, make sure your app target is checked. Then click Finish.

Now that you’ve integrated the frameworks in your application, it’s time to start the SDK and make use of the App Center services.

4. Start the SDK

To use App Center, opt in to the module(s) that you want to use. By default, no modules are started and you must call each one when starting the SDK.

The instructions below are slightly different depending on what lifecycle you’re using. Starting from Xcode 12 you can select one of two lifecycles: «Swift UI App» (selected by default in Xcode 12) and «UI Kit AppDelegate». If you’re using Xcode 11 or lower, then you’re using UI Kit AppDelegate lifecycle. If you’re developing for an extension, refer to the Extension getting started page.

4.1 Add the import statements

Open the project’s AppDelegate file (for UI Kit AppDelegate lifecycle) or App.swift file (for Swift UI App lifecycle) and add the following import statements:

4.2 Add the start:withServices: method

UI Kit AppDelegate

Add initialization code into didFinishLaunchingWithOptions delegate method.

Swift UI App lifecycle

Create init() method into struct and add initialization code in it.

Use this code into methods described before, to start SDK:

If you have a Catalyst application, you can pass app secrets for both iOS and macOS at the same time:

If you need to start App Center services separately, you should:

1. Configure or start it with the App Secret.
2. If the code can be called multiple times, check if the App Center is already configured.
3. Start the required service(s) without the App Secret.

4.3 Replace the placeholder with your App Secret

Make sure to replace text with the actual value for your application. The App Secret can be found on the Getting Started page or Settings page on the App Center portal.

The Getting Started page contains the above code sample with your App Secret in it, you can copy-paste the whole sample.

The example above shows how to use the start:withServices ( start(withAppSecret:services:) for Swift) method and include both App Center Analytics and App Center Crashes.

If you don’t want to use one of the two services, remove the corresponding parameter from the method call above.

Unless you explicitly specify each module as a parameter in the start method, you can’t use that App Center service. Also, the start:withServices ( start(withAppSecret:services:) for Swift) API can be used only once in the lifecycle of your app – all other calls will log a warning to the console and only the modules included in the first call will be available.

For example — If you want to onboard to App Center Analytics, you should modify the start:withServices ( start(withAppSecret:services:) for Swift) API call as follows:

Great, you’re all set to visualize Analytics and Crashes data on the portal that the SDK collects automatically.

Look at the App Center Analytics docs and App Center Crashes docs to learn how to customize and use more advanced functionalities of both services.

To learn how to get started with in-app updates, read the documentation of App Center Distribute.

To learn how to get started with Push, read the documentation of App Center Push.

Лучшие iOS SDK инструменты за 2019 год

В 2019 году появилось множество приложений для iOS, которые однозначно стоит добавить на главный экран вашего устройства. Например, Mobike для бесстанционного проката велосипедов, Blinkist для чтения или прослушивания краткого пересказа и Oh She Glows для поиска популярных вегетарианских рецептов.

Каждое из этих приложений полностью отличается по задумке, но их объединяет то, что они стремятся предложить фантастический пользовательский опыт.

Достижение великолепного пользовательского опыта зависит от многих факторов. Прежде всего, вам необходимо отказаться от такого понятия как “финальный продукт”. Команды разработчиков самых коммерчески успешных приложений постоянно наблюдают, тестируют и доводят до ума каждую мелкую деталь. Вы спросите: “Как мне это сделать?”. Частично ответ на данный вопрос зависит от вашего руководства и нацеленности команды на результат, но по большей части от тех инструментов, которые вы используете в работе. В нашем случае — это iOS SDK (комплект средств разработки для iOS).

1. iOS SDK для сбора отзывов: UserTesting

UserTesting — это платформа, включающая более миллиона тестировщиков, которые помогут сформировать мнение о вашем продукте всего за несколько часов. На платформе можно указать, какая целевая аудитория вас интересует. Кроме того, платформу можно использовать в качестве площадки для проведения опросов пользователей. UserTesting позволяет тестировщикам записывать видео для получения более ясных отзывов. Данный инструмент также автоматически транскрибирует устные комментарии пользователей для их легкого просмотра.

Ключевые особенности:

• Обширная сеть с более чем миллионом пользователей.
• Опрос пользователей.
• Наличие видео отзывов и их автоматическое транскрибирование.

2. iOS SDK для взаимодействия с пользователями: Leanplum

Leanplum — это мощная платформа, включающая в себя набор инструментов для взаимодействия с клиентами, мобильного маркетинга и многого другого. Leanplum поможет автоматизировать кампании с различными способами контакта с пользователями (электронные письма, push-уведомления, уведомления в приложении и т.д). С помощью Leanplum вы сможете обратиться к пользователю, следуя определенному сценарию, и выстроить с ним крепкие деловые отношения.

Ключевые особенности:

• Разнообразие способов контакта с пользователями.
• Возможность отправления сообщений в приложении.
• Наличие push-уведомлений.

3. iOS SDK для аналитики действий пользователей: Appsee

Appsee — это высококачественная аналитическая платформа, созданная для анализа поведения пользователей в приложениях. Appsee включает в себя видеозаписи сессий и тепловую карту кликов, а также интегрирует их в другие встроенные инструменты для аналитики: воронку конверсии, когортный анализ, карту поведения и даже в видеозаписи с ошибками, которые позволяют командам разработчиков воспроизводить последовательности, приведшие к неисправности. Также Appsee включает сторонние интеграции с известными платформами, такими как AppsFlyer, Crashlytics, Optimizely, Salesforce, Slack и другими. Для интеграции Appsee SDK в ваше приложение потребуется всего одна строка кода.

Ключевые особенности:

• Видеозапись сессий.
• Тепловая карта кликов.
• Пользовательские сценарии и карта пути пользователя.

4. iOS SDK для отслеживания ошибок: Instabug

Instabug — еще один SDK со множеством функций, включающий в себя инструмент для составления отчетов об ошибках для пользователей и для отправления вам необходимой информации о трассировке стека без навигационной цепочки. Также у вас есть возможность увидеть, как работает текущая версия по сравнению с предыдущими, и ознакомиться с видеозаписями сессий ваших пользователей. Instabug можно интегрировать с вашим workflow, чтобы отправлять предупреждения всей вашей команде через Slack и JIRA.

Ключевые особенности:

• Видеозапись сессий для составления отчетов об ошибках.
• Интерактивная обратная связь с пользователями.

5. iOS SDK для A/B тестирования: Optimizely

Optimizely — это платформа для экспериментов, предлагающая решения для веб-страниц и мобильных приложений. Инструмент позволяет плавно экспериментировать в режиме реального времени с любой частью вашего приложения или веб-страницы. Это позволяет выяснить при каких условиях растёт доход, увеличиваются регистрации и загрузки. И вам не нужно ждать отзыва в App Store, чтобы узнать, что конкретно необходимо изменить. Optimizely дает возможность настроить таргетинг, время и распределение аудитории при проведении тестирования.

Ключевые особенности:

• Мгновенное и поэтапное развертывание
• Визуальный редактор
• Распределение аудитории и расширенный таргетинг

6. iOS SDK для обратной связи с пользователями: ForeSee

ForeSee предлагает набор многоканальных инструментов для формирования “клиентского опыта”, включая self-service инструмент обратной связи с пользователями. С помощью ForeSee Feedback, вы можете стимулировать пользователей заполнять простые опросы и сообщать о проблемах до того, как те превратятся в снежный ком. Кроме того, у вас есть возможность быстро задеплоить окно с рейтингом для ценных пользователей. Также ForeSee позволяет воспроизвести пользовательскую сессию, обеспечивая целостное представление о UX во время работы вашего приложения.

Ключевые особенности:

• Простой self-service деплой.
• Возможность для пользователей поставить оценку и оставить отзыв.
• Воспроизведение пользовательских сессий.

7. iOS SDK для электронных платежей: Stripe

С помощью всего нескольких строк кода Stripe iOS SDK позволяет безопасно получить информацию о кредитной карте, не собирая PCI данные и используя автоматизированную систему идентификации мошенничества, основанную на машинном обучении. Stripe позволяет пользователям настраивать пользовательский интерфейс с помощью предварительно созданных и проверенных временем UI компонентов на сайтах и в мобильных приложениях. Удобный пользовательский интерфейс и настраиваемые параметры/виды оплаты в совокупности создают самый удобный и надежный процесс оплаты для ваших клиентов.

Ключевые особенности:

• Встроенная проверка.
• Настраиваемый набор UI компонентов.
• Предотвращение мошенничества на основе машинного обучения.

8. iOS SDK для создания карт: Mapbox

Mapbox — это платформа, предназначенная для создания и публикации своих собственных карт. Этот iOS SDK помогает создавать приложения, использующие данные о локации для управления какими-либо функциями, в нескольких категориях, включая транспорт, путешествия, навигацию и даже AR. Конечно, разработчики могут использовать и заранее разработанные карты. Платформа использует сеть из более чем 400 миллионов пользователей.

Ключевые особенности:

• Настройка цвета дорог, линий границ, географических названий и т.д.
• Поддержка оффлайн карт.
• Навигация.

Заключение

“Лучшие” iOS SDK инструменты — это те, которые позволяют вам воплощать свежие идеи в жизнь, уверенно работать с данными и быстро их оптимизировать. Этот список поможет лучше ориентироваться в потребностях ваших пользователей, что, в конечном итоге, позволит повысить время удержания клиентов и поможет улучшить с ними деловые отношения.