Начало работы с сетью Vungle: iOS SDK v. 1.0 - v.4.1 (Swift)

В этом руководстве я расскажу на примере, как быстро встроить наш SDK для системы iOS в обычное приложение, используя Swift. Упоминаемый здесь исходный код можно найти в нашем публичном хранилище GitHub.

Прежде чем приступать к работе, отметим несколько моментов.

  • Комплект разработчика Vungle iOS SDK поддерживает только iOS версии 6 и старше.
  • Для встраивания требуется учетная запись Vungle, поэтому если у вас ее еще нет — создайте.
  • Зайдите впанель управления и добавьте приложение в свою учетную запись, если вы этого еще не сделали. Это нужно для того, чтобы получить идентификатор приложения App ID, который будет добавляться в приложение с помощью нашего SDK. На странице приложения этот идентификатор выделяется красным.

Теперь можем приступать. Вся процедура проводится в 5 этапов:

1. Добавляем фреймворк Vungle в проект Xcode

Пакет Vungle iOS SDK не включен в пример кода (см. выше) — его нужно загрузить с панели управления Vungle.

Распакуйте его и скопируйте VungleSDK.embeddedframework / в каталог проекта. Затем перетащите его в Xcode (раздел «Frameworks»), чтобы связать фреймворк с проектом.

Фреймворк VungleSDK.embeddedframework нужно добавлять как группу (желтая папка), а не как ссылку (синяя папка).

2. Добавляем остальные необходимые фреймворки

Для работы фреймворка Vungle SDK необходимо связать с проектом некоторые «родные» фреймворки. Щелкам на проект и переходим сюда:

General > Linked Frameworks and Libraries

Многие из необходимых фреймворков уже включены в проект (они по умолчанию используются в большинстве проектов Xcode), и нам остается добавить остальные из следующего списка:

 

Также следует проверить, находится ли фреймворк VungleSDK в списке «Linked Frameworks and Libraries». Если после перетаскивания фреймворк не привязался автоматически, его можно добавить вручную, „+“, а затем — «Add Other».

3. Удаляем строку состояния iOS

Делать это необязательно, но рекомендуется: если убрать строку состояния, реклама Vungle будет отображаться более аккуратно, и взаимодействие с ней будет более удобным. Чтобы удалить строку состояния, откройте Info.pList, добавьте ключ «View controller-based status bar appearance» и задайте ему значение «No».

4. Создаем связующий заголовочный файл

  • Создайте в проекте новый файл Objective C (File -> New -> File [Objective C for iOS]).
  • Xcode спросит, нужно ли создавать заголовочный файл для связи Objective C и Swift — соглашайтесь.

 

  • Удалите файл Objective C, но оставьте связующий заголовочный файл «${YOURPROJ}-Bridging-Header.h».
  • Импортируйте в этом файле Vungle: добавьте „#import <VungleSDK/VungleSDK.h>“.

5. Пишем код!

  • Инициализация SDK. Важно пораньше инициализировать SDK, чтобы реклама успела предварительно загрузиться. В этом примере мы добавим вызов инициализации в метод didFinishLaunchingWithOptions главного объекта AppDelegate.

AppDelegate.swift: didFinishLaunchingWithOptions:

var appID = "Your AppID Here"
var sdk = VungleSDK.sharedSDK()
// start vungle publisher library
sdk.startWithAppId(appID)
  • Проигрывание рекламы в контроллерах ViewController. Мы инициализировали SDK в методе didFinishLaunchingWithOptions объекта AppDelegate, и теперь можем показать рекламу пользователю, просто добавив следующий фрагмент кода в.

  • TopViewController.swift
    var sdk = VungleSDK.sharedSDK()
    sdk.playAd(self, error: nil)
    

    В параметр NSError будут включаться сведения об ошибке — на случай, если во время показа рекламы что-то пойдет не так.

Расширенные настройки

Если вам интересно покопаться в настройках пакета Vungle iOS SDK (настройки, слушателей событий и т. д.) почитайте наше руководство по расширенным настройкам. В образце приложения на языке Swift можно увидеть примеры параметров метода playAd.

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 1 из 1
Еще есть вопросы? Отправить запрос

Комментарии