Подготовка к работе с мобильным клиентом

improve this page | report issue

Обзор

Для установки приложений на мобильных устройствах применяется приложение Appcenter Installer. Это приложение можно создать с помощью предоставленных проектов Cordova, Visual Studio, MobileFirst Studio. Кроме того, можно использовать предварительно скомпонованную версию проекта MobileFirst Studio для Android, iOS или Windows 8 Universal.

Перейти к

Предварительные требования

Предварительные требования для операционной системы Android

Нативная версия мобильного клиента для Android поставляется в виде файла пакета приложения Android (.apk) в рамках процесса доставки программного обеспечения. Файл IBMApplicationCenter.apk расположен в каталоге ApplicationCenter/installer. Push-уведомления выключены. Для того чтобы включить push-уведомления, необходимо перекомпоновать файл .apk. Дополнительная информация о push-уведомлениях в Application Center приведена в разделе Push-уведомления об обновлениях приложений.

Для компоновки версии Android требуется последняя версия инструментов разработки Android.

Предварительные требования для операционной системы Apple iOS

Нативная версия скомпилированного приложения iOS для iPad и iPhone не поставляется. Приложение необходимо создать на основе проекта IBM Mobile Foundation с именем IBMAppCenter. Этот проект доступен в каталоге ApplicationCenter/installer.

Для компоновки версии iOS требуются продукт IBM Mobile Foundation и программное обеспечение Apple. Версия MobileFirst Studio должна совпадать с версией сервера MobileFirst Server, к которой относится эта документация. Версия Apple Xcode: V6.1.

Предварительные требования для операционной системы Microsoft Windows Phone

Версия мобильного клиента для Windows Phone поставляется в виде файла пакета приложения Windows Phone (.xap) без подписи в рамках процесса доставки программного обеспечения. Файл IBMApplicationCenterUnsigned.xap расположен в каталоге ApplicationCenter/installer.

Важная информация: файл .xap без подписи нельзя использовать сам по себе. Перед установкой на устройстве его необходимо подписать с помощью сертификата компании, полученного в Symantec/Microsoft.

Необязательно: при необходимости версию Windows Phone можно скомпоновать из исходных файлов. Для этого требуется последняя версия Microsoft Visual Studio.

Предварительные требования для операционной системы Microsoft Windows 8

Версия мобильного клиента для Windows 8 поставляется в виде файла .zip. Файл IBMApplicationCenterWindowsStore.zip содержит исполняемый файл (.exe) и его зависимые файлы динамически подключаемых библиотек (.dll). Для применения содержимого этого архива необходимо загрузить его на локальный диск и запустить исполняемый файл.

Необязательно: при необходимости версию для Windows 8 можно скомпоновать из исходных файлов. Для этого требуется последняя версия Microsoft Visual Studio.

Клиент IBM AppCenter на основе Cordova

Проект клиента AppCenter на основе Cordova расположен в каталоге install: install_dir/ApplicationCenter/installer/CordovaAppCenterClient.

Этот проект создан на основе среды Cordova и не зависит от API клиента/сервера Mobile Foundation.
Поскольку это стандартное приложение Cordova, оно также не зависит от MobileFirst Studio. В качестве пользовательского интерфейса приложения применяется Dojo.

Для начала работы выполните следующие действия:

  1. Установите Cordova.
npm install -g cordova@latest
  1. Установите SDK Android и укажите переменную ANDROID_HOME.
  2. Скомпонуйте и запустите этот проект.

Компоновка для всех платформ:

cordova build

Компоновка только для Android:

cordova build android

Компоновка только для iOS:

cordova build ios

Настройка приложения AppCenter Installer

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

Примечание: несмотря на то, что вы можете вносить произвольные изменения в пользовательский интерфейс и поведение приложения, на такие изменения не распространяется соглашение о поддержке IBM.

Android

  • Откройте Android Studio.
  • Выберите Импортировать проект (Eclipse ADT, Gradle и т. д.)
  • Выберите папку android в каталоге install_dir/ApplicationCenter/installer/CordovaAppCenterClient/platforms/android.

Это может занять некоторое время. После завершения этой операции вы можете приступить к настройке.

Примечание: во всплывающем окне выберите опцию, позволяющую пропустить обновление версии gradle. Версия указана в файле grade-wrapper.properties.

iOS

  • Перейдите в каталог install_dir/ApplicationCenter/installer/CordovaAppCenterClient/platforms.
  • Щелкните, чтобы открыть файл IBMAppCenterClient.xcodeproj. Проект открывается в Xcode и будет готов к настройке.

Клиент IBM AppCenter на основе MobileFirst Studio

Вместо проекта Cordova для iOS и Android можно использовать предыдущий выпуск клиентского приложения App Center, который основан на MobileFirst Studio 7.1 и поддерживает iOS, Android и Windows Phone.

Импорт и компоновка проекта (Android, iOS, Windows Phone)

Необходимо импортировать проект IBMAppCenter в MobileFirst Studio и скомпоновать его.

Примечание: Для V8.0.0 следует использовать MobileFirst Studio 7.1. MobileFirst Studio можно загрузить на странице Загрузки. Инструкции по установке приведены в разделе Установка MobileFirst Studio в справочной системе IBM Knowledge Center для версии 7.1.

  1. Выберите Файл → Импортировать.
  2. Выберите Общие → Существующий проект в рабочую область.
  3. На следующей странице выберите Выбрать корневой каталог и найдите корневой каталог проекта IBMAppCenter.
  4. Выберите проект IBMAppCenter.

  5. Выберите Скопировать проекты в рабочую область. При этом создается копия проекта в рабочей области. Поскольку в системах UNIX проект IBMAppCenter доступен только для чтения в исходном расположении, копирование проектов в рабочую область помогает избежать неполадок, связанных с правами доступа к файлам.

  6. Нажмите кнопку Готово, чтобы импортировать проект IBMAppCenter в MobileFirst Studio.

Скомпонуйте проект IBMAppCenter. Проект MobileFirst содержит одно приложение с именем AppCenter. Щелкните на приложении правой кнопкой мыши и выберите Выполнить как → Скомпоновать все среды.

Импорт и компоновка проекта в Android

MobileFirst Studio создает нативный проект Android в каталоге IBMAppCenter/apps/AppCenter/android/native. Нативный проект для инструментов разработки Android (ADT) доступен в папке android/native. Этот проект можно скомпилировать и подписать с помощью инструментов ADT. Для этого проекта в системе должен быть установлен SDK Android уровня 16, чтобы полученный APK был совместим с Android версии 2.3 и выше. Если при компоновке проекта выбран SDK Android более высокого уровня, то полученный APK не будет совместим с Android версии 2.3.

Дополнительная информация о мобильном клиентском приложении приведена на сайте Android для разработчиков.

Для того чтобы включить push-уведомления для обновлений приложения, сначала необходимо настроить свойства клиента Application Center. См. раздел Настройка push-уведомлений об обновлении приложения.

Импорт и компоновка проекта в iOS

MobileFirst Studio создает нативный проект iOS в каталоге IBMAppCenter/apps/AppCenter/iphone/native. Файл IBMAppCenterAppCenterIphone.xcodeproj расположен в папке iphone/native. Этот файл представляет собой проект Xcode, который требуется скомпилировать и подписать с помощью Xcode.

Дополнительная информация о подписании мобильного клиентского приложения iOS приведена на сайте для разработчиков Apple. Для того чтобы подписать приложение iOS, для приложения необходимо указать идентификатор комплекта приложения, который можно использовать с применяемым профайлом предоставления. Значение указано в параметрах проекта Xcode в следующем виде: com.your_internet_domain_name.appcenter, где your_internet_domain_name - это имя вашего интернет-домена.

Для того чтобы включить push-уведомления для обновлений приложения, сначала необходимо настроить свойства клиента Application Center. См. раздел Настройка push-уведомлений об обновлении приложения.

Windows Phone 8

MobileFirst Studio создает нативный проект Windows Phone 8 в каталоге IBMAppCenter/apps/AppCenter/windowsphone8/native. Файл AppCenter.csproj расположен в папке windowsphone8/native. Этот файл представляет собой проект Visual Studio, который компилируется с помощью Visual Studio и SDK Windows Phone 8.0.

Приложение компонуется с помощью SDK Windows Phone 8.0 для работы на устройствах Windows Phone 8.0 и 8.1. Для компоновки не применяется SDK Windows Phone 8.1, поскольку в этом случае приложение не будет работать на устройствах Windows Phone 8.0.

В ходе установки Visual Studio 2013 можно выбрать экземпляр SDK Windows Phone 8.0 в дополнение к SDK 8.1. Кроме того, SDK Windows Phone 8.0 можно загрузить на веб-странице Архивы SDK Windows Phone.

Дополнительная информация о компоновке и подписании мобильного клиентского приложения Windows Phone приведена на веб-странице Windows Phone Dev Center.

Microsoft Windows 8: компоновка проекта

Проект Windows 8 Universal представляет собой проект Visual Studio: IBMApplicationCenterWindowsStore\AppCenterClientWindowsStore.csproj.
Перед распространением проект клиента необходимо скомпоновать в Microsoft Visual Studio

Компоновка проекта является одним из предварительных требований для его распространения среди пользователей, однако приложение Windows 8 не предназначено для развертывания в Application Center с целью дальнейшего распространения.

Для компоновки проекта Windows 8 выполните следующие действия:

  1. Откройте файл проекта Visual Studio с именем IBMApplicationCenterWindowsStore\AppCenterClientWindowsStore.csproj в Microsoft Visual Studio 2013.
  2. Выполните полную компоновку приложения.

Для того чтобы предоставить пользователям Application Center доступ к мобильному клиенту, можно создать программу установки, отвечающую за установку созданного исполняемого файла (.exe) и зависимых динамически подключаемых библиотек (.dll). Кроме того, эти файлы можно предоставить без добавления в программу установки.

Клиент IBM AppCenter Microsoft Windows 10 Universal (нативный)

Нативный клиент IBM AppCenter Window 10 Universal можно использовать для установки приложений Windows 10 Universal на телефонах Windows 10. Для установки приложений Windows 10 в настольной версии Windows следует использовать IBMApplicationCenterWindowsStore.

Microsoft Windows 10 Universal: компоновка проекта

Проект Windows 10 Universal представляет собой проект Visual Studio: IBMAppCenterUWP\IBMAppCenterUWP.csproj.
Перед распространением проект клиента необходимо скомпоновать в Microsoft Visual Studio

  1. Компоновка проекта является предварительным требованиям для его распространения среди пользователей

Для компоновки проекта Windows 10 Universal выполните следующие действия:

  1. Откройте файл проекта Visual Studio с именем IBMAppCenterUWP\IBMAppCenterUWP.csproj в Microsoft Visual Studio 2015.
    • Выполните полную компоновку приложения.
    • Создайте файл .appx, выполнив следующие действия:
      • Щелкните на проекте правой кнопкой мыши и выберите Магазин → Создать пакеты приложения.

Настройка компонентов (для опытных пользователей): Android, iOS, Windows Phone

Для настройки компонентов необходимо внести изменения в центральный файл свойств и ряд других ресурсов.

Такая возможность поддерживается только в Android, iOS, Windows 8 (только пакеты Windows Store) и Windows Phone 8.

Настройка функций: отдельные функции настраиваются с помощью центрального файла свойств config.json, который расположен в каталоге IBMAppCenter/apps/AppCenter/common/js/appcenter/ или ApplicationCenter/installer/CordovaAppCenterClient/www/js/appcenter. Если требуется изменить алгоритм работы приложения по умолчанию, внесите изменения в этот файл перед компоновкой проекта.

Этот файл содержит свойства, перечисленные в следующей таблице.

Свойство Описание
url Фиксированный адрес сервера Application Center. Если это свойство задано, то в представлении входа в систему не отображаются поля адреса.
defaultPort Если свойство url не задано, то это свойство отображается в поле Порт в представлении входа в систему на телефоне. Это значение по умолчанию; пользователь может указать в этом поле другое значение.
defaultContext Если свойство url не задано, то это свойство отображается в поле Контекст в представлении входа в систему на телефоне. Это значение по умолчанию; пользователь может указать в этом поле другое значение.
ssl Значение по умолчанию переключателя SSL в представлении входа в систему.
allowDowngrade Это свойство указывает, разрешена ли установка предыдущих версий; предыдущую версию можно установить только в том случае, если это разрешено операционной системой и версией.
showPreviousVersions Это свойство указывает, может ли пользователь устройства просматривать сведения о всех версиях приложений или только о последней версии.
showInternalVersion Это свойство указывает, отображается ли внутренняя версия. Если указано значение false, то внутренняя версия отображается только в том случае, если коммерческая версия не задана.
listItemRenderer Для этого свойства допустимы следующие значения:
- full: значение по умолчанию; в списках приложений отображаются имя, рейтинг и последняя версия приложения.
- simple: в списках приложений отображается только имя приложения.
listAverageRating Для этого свойства допустимы следующие значения:
- latestVersion: в списках приложений отображается средний рейтинг последней версии приложения.
- allVersions: в списках приложений отображается средний рейтинг всех версий приложения.
requestTimeout Это свойство задает тайм-аут в миллисекундах для запросов к серверу Application Center.
gcmProjectId ИД проекта API Google (имя проекта = com.ibm.appcenter), необходимый для push-уведомлений Android; пример: 123456789012.
allowAppLinkReview Это свойство указывает, можно ли в Application Center регистрировать и просматривать локальные отзывы о приложениях из внешних магазинов приложений. Локальные отзывы не отображаются во внешних магазинах приложений. Они хранятся на сервере Application Center.

Другие ресурсы

Также доступны следующие ресурсы: значки приложения, имя приложения, заставки, значки и переводимые ресурсы приложения.

Значки приложения

  • Android: файл icon.png в каталогах res/drawable/density проекта Android Studio; для каждого разрешения создается отдельный каталог.
  • iOS: файлы iconsize.png в каталоге Resources проекта Xcode.
  • Windows Phone: файлы ApplicationIcon.png, IconicTileSmallIcon.png и IconicTileMediumIcon.png в каталоге native в папке среды MobileFirst Studio для Windows Phone.
  • Windows 10 Universal: файлы Square*Logo*.png, StoreLogo.png и Wide*Logo*.png в каталоге IBMAppCenterUWP/Assets Visual Studio.

Имя приложения

  • Android: измените свойство app_name в файле res/values/strings.xml из проекта Android Studio.
  • iOS: измените параметр CFBundleDisplayName в файле IBMAppCenterAppCenterIphone-Info.plist из проекта Xcode.
  • Windows Phone: измените атрибут Title записи App в файле Properties/WMAppManifest.xml в Visual Studio.
  • Windows 10: измените атрибут Title записи App в файле IBMAppCenterUWP/Package.appxmanifest в Visual Studio.

Заставки

  • Android: измените файл splashimage.9.png в каталогах res/drawable/density проекта Android Studio; для каждого разрешения создается отдельный каталог. Этот файл представляет собой изображение patch 9.
  • iOS: файлы Default-size.png в каталоге Resources проекта Xcode.
  • Заставка проектов на основе Cordova/MobileFirst в случае автоматического входа в систему: js/idx/mobile/themes/common/idx/Launch.css
  • Windows Phone: измените файл SplashScreenImage.png в каталоге native среды MobileFirst Studio для Windows Phone.
  • Windows 10 Universal: измените файлы SplashScreen*.png в каталоге IBMAppCenterUWP/Assets в Visual Studio.

Значки приложения (кнопки, звездочки и аналогичные объекты)

IBMAppCenter/apps/AppCenter/common/css/images.

Переводимые ресурсы приложения

IBMAppCenter/apps/AppCenter/common/js/appcenter/nls/common.js.

Развертывание мобильного клиента в Application Center

Разверните разные версии клиентского приложения в Application Center.

Мобильный клиент Windows 8 не предназначен для развертывания в Application Center с целью дальнейшего распространения. Для распространения мобильного клиента Windows 8 предоставьте пользователям архив, содержащий исполняемый файл клиента .exe и динамически подключаемые библиотеки .dll, или создайте исполняемую программу установки для мобильного клиента Windows 8.

Версии мобильного клиента для Android, iOS, Windows Phone и Windows 10 Universal (Phone) должны быть развернуты в Application Center. Для этого необходимо передать файлы пакетов приложений Android (.apk), файлы приложений iOS (.ipa), файлы приложений Windows Phone (.xap), файлы Windows 10 Universal (.appx) или файлы архивов веб-каталогов (.zip) в Application Center.

Добавьте приложение мобильного клиента для Android, iOS, Windows Phone или Windows 10 Universal в соответствии с инструкциями из раздела Добавление мобильного приложения . Выберите свойство, указывающее, что приложение представляет собой программу установки. В этом случае пользователи мобильных устройств смогут устанавливать приложение мобильного клиента по беспроводной сети. Инструкции по установке мобильного клиента приведены в описании связанной задачи, соответствующей версии приложения мобильного клиента, определенной операционной системой.

▲
Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.
Last modified on August 17, 2020