Сквозная демонстрация для Cordova

Обзор

В этой демонстрации рассматриваются все этапы потока:

1. Пример приложения, поставляемый вместе с SDK клиента MobileFirst, регистрируется и загружается с помощью MobileFirst Operations Console.
2. В MobileFirst Operations Console развертывается новый или предоставленный адаптер.
3. В логику приложения вносятся изменения для запроса ресурса.

Конечный результат:

• Проверка связи с MobileFirst Server.
• Успешное извлечение данных с помощью адаптера.

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

• Xcode для iOS, Android Studio для Android или Visual Studio 2013/2015 для Windows 8.1 Universal / Windows 10 UWP
• Cordova CLI 6.x.
• Необязательно. MobileFirst CLI (загрузить)
• Необязательно. Автономный экземпляр MobileFirst Server (загрузить)

1. Запуск MobileFirst Server

Убедитесь, что создан экземпляр Mobile Foundation либо
В случае применения MobileFirst Developer Kit перейдите в папку сервера и выполните следующую команду: ./run.sh (Mac и Linux) или run.cmd (Windows).

2. Создание и регистрация приложения

В браузере откройте MobileFirst Operations Console с помощью следующего URL: http://your-server-host:server-port/mfpconsole. В локальном режиме введите следующий адрес: http://localhost:9080/mfpconsole. Идентификационные данные пользователя: admin/admin.

1. Нажмите кнопку Создать рядом с разделом Приложения
   • Выберите платформу: Android, iOS, Windows
   • Введите com.ibm.mfpstartercordova в качестве идентификатора приложения
   • Введите 1.0.0 в качестве версии
   • Нажмите кнопку Зарегистрировать приложение

   

2. Щелкните на плитке Получить начальный код и выберите загрузку примера приложения Cordova.

   

3. Изменение логики приложения

1. Откройте проект Cordova в предпочитаемом редакторе исходного кода.

2. Выберите файл www/js/index.js и вставьте следующий фрагмент кода, заменив существующую функцию WLAuthorizationManager.obtainAccessToken():

WLAuthorizationManager.obtainAccessToken()
    .then(
        function(accessToken) {
            titleText.innerHTML = "Yay!";
            statusText.innerHTML = "Connected to MobileFirst Server";

            var resourceRequest = new WLResourceRequest(
                "/adapters/javaAdapter/resource/greet/",
                WLResourceRequest.GET
            );

            resourceRequest.setQueryParameter("name", "world");
            resourceRequest.send().then(
                function(response) {
                    // Will display "Hello world" in an alert dialog.
                    alert("Success: " + response.responseText);
                },
                function(response) {
                    alert("Failure: " + JSON.stringify(response));
                }
            );
        },

        function(error) {
            titleText.innerHTML = "Bummer...";
            statusText.innerHTML = "Failed to connect to MobileFirst Server";
        }
    );

4. Развертывание адаптера

Загрузите этот подготовленный артефакт .adapter и разверните его с помощью MobileFirst Operations Console. Для этого выберите Действия → Развернуть адаптер.

Кроме того, можно нажать кнопку Создать рядом с разделом Адаптеры.

1. Выберите Действия → Загрузить пример. Загрузите пример адаптера Java “Hello World”.

   Если Maven и MobileFirst CLI не установлены, выполните инструкции по настройке среды разработки.

2. В окне Командная строка перейдите в корневую папку проекта Maven адаптера и выполните следующую команду:

    mfpdev adapter build
   

3. После завершения компоновки разверните адаптер с помощью MobileFirst Operations Console. Для этого выберите Действия → Развернуть адаптер. Адаптер расположен в папке [adapter]/target.

   

5. Тестирование приложения

1. В окне Командная строка перейдите в корневую папку проекта Cordova.
2. Выполните команду cordova platform add ios|android|windows для добавления платформы.
3. В проекте Cordova выберите файл config.xml и укажите в элементе <mfp:server ... url=" "/> значения свойств protocol, host и port с учетом конфигурации MobileFirst Server.
   • Обычные значения в случае применения локального экземпляра MobileFirst Server: http, localhost и 9080.
   • Обычные значения в случае применения удаленного экземпляра MobileFirst Server (в IBM Cloud): https, your-server-address и 443.
   • В случае применения кластера Kubernetes в IBM Cloud Private и развертывания с типом NodePort значением порта, как правило, будет значение NodePort, предоставляемое службой в кластере Kubernetes.

   Кроме того, если установлен MobileFirst CLI, перейдите в корневую папку проекта и выполните команду mfpdev app register. В случае применения удаленного экземпляра MobileFirst Server выполните команду mfpdev server add для добавления сервера, а затем выполните команду, аналогичную следующей: mfpdev app register myIBMCloudServer.

Если устройство подключено, то приложение устанавливается и запускается на устройстве.
В противном случае применяется симулятор или эмулятор.

Результаты

• При нажатии кнопки Проверить связь с MobileFirst Server выдается сообщение Установлено соединение с MobileFirst Server.
• Если приложению удалось подключиться к MobileFirst Server, ресурс запрашивается с помощью развернутого адаптера Java.

Ответ адаптера отображается в предупреждении.

Дальнейшие действия

Узнайте больше об использовании адаптеров в приложениях, интеграции дополнительных служб, таких как Push-уведомления, с помощью среды защиты MobileFirst и других вопросах:

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