API для Android

Возможности библиотеки

• Определение, запущено ли Android-приложение на устройстве под управлением Headwind MDM
• Получение настроек приложения с сервера по ID устройства
• Отправка журналов на сервер (правила отправки журналов настраиваются на сервере по ID устройства)
• Получение Push-уведомлений, отправляемых серверными плагинами

Список классов

• HeadwindMDM
• HeadwindMDM.EventHandler
• MDMError
• MDMException
• MDMPushHandler
• MDMPushMessage
• MDMService
• MDMService.ResultHandler
• MDMService.Log
• MDMService.Preferences

Пример кода

Интеграция

Для подключения библиотеки в ваше приложение, вам нужно:

1. Загрузить последнюю версию библиотеки Headwind MDM hmdm-X.X.X.aar и скопировать ее в ваш проект в поддиректорию libs
2. Добавить строку в build.gradle (уровень модуля):
   implementation files('libs/hmdm-1.1.3.aar')
   (при необходимости замените номер версии на последнюю версию библиотеки).
3. Добавить возможность взаимодействия с приложением Headwind MDM package в AndroidManifest.xml внутри тега <manifest>:

       <queries>
           <package android:name="com.hmdm.launcher" />
       </queries>  

HeadwindMDM

HeadwindMDM.EventHandler

MDMError

MDMException

MDMPushHandler

MDMPushMessage

MDMService

MDMService.ResultHandler

MDMService.Log

MDMService.Preferences

Примеры кода

Версия 1.1.0 и выше

Чтобы включить функции Headwind MDM в ваше Android-приложение, используйте в качестве примера следующий код:

public class MainActivity extends AppCompatActivity implements HeadwindMDM.EventHandler {
    ...
    private HeadwindMDM headwindMDM;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ...
        headwindMDM = HeadwindMDM.getInstance();
    }
 
    @Override
    protected void onResume() {
        super.onResume();
        ...
        if (!headwindMDM.isConnected()) {
            if (!headwindMDM.connect(this, this)) {
                // Ошибка соединения с Headwind MDM, скорее всего приложение запущено вне среды Headwind MDM
            }
        }
    }
 
    @Override
    protected void onDestroy() {
        headwindMDM.disconnect(this);
        super.onDestroy();
    }
 
    @Override
    public void onHeadwindMDMConnected() {
        // Подключились к Headwind MDM, теперь можно получить настройки и выполнить другие функции , относящиеся к MDM
        loadSettings();
    }
 
    @Override
    public void onHeadwindMDMDisconnected() {
    }
 
    @Override
    public void onHeadwindMDMConfigChanged() {
        // Настройки на сервере изменились, нужно их обновить в приложении
        loadSettings();
    }

    // Получение настроек приложения с сервера
    private void loadSettings() {
        String someSetting = MDMService.Preferences.get("some_setting", getString(R.string.default_setting));
    }
}

Версии библиотеки до 1.1.0

В этом коде требуется вручную реализовать повторное подключение в случае разрыва соединения с сервисом (например, в случае обновления лаунчера Headwind MDM).

public class MainActivity extends AppCompatActivity implements MDMService.ResultHandler {
    ...
    private MDMService mdmService;
    private boolean mdmConnected = false;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ...
        mdmService = MDMService.getInstance();
    }
 
    @Override
    protected void onResume() {
        super.onResume();
        ...
        if (mdmConnected) {
            // Если мы уже соединены с Headwind MDM, загрузим настройки MDM и выполним здесь другие функции, относящиеся к MDM
            String someSetting = MDMService.Preferences.get("some_setting", getString(R.string.default_setting));
        } else {
            if (!mdmService.connect(this, this)) {
                // Ошибка соединения с Headwind MDM, скорее всего приложение запущено вне среды Headwind MDM
            }
        }
    }
 
    @Override
    public void onMDMConnected() {
        mdmConnected = true;
        // Подключились к Headwind MDM, теперь можно получить настройки и выполнить другие функции , относящиеся к MDM
        String someSetting = MDMService.Preferences.get("some_setting", getString(R.string.default_setting));
    }
 
    @Override
    public void onMDMDisconnected() {
        mdmConnected = false;
        // Повтор соединения через 5 секунд (сюда попадаем после обновления или аварийного завершения лаунчера)
        new Handler().postDelayed(new MDMReconnectRunnable(), 5000);
    }
 
    public class MDMReconnectRunnable implements Runnable {
        @Override
        public void run() {
            if (!mdmService.connect(MainActivity.this, MainActivity.this)) {
                // Повтор через 1 минуту
                new Handler().postDelayed(this, 60000);
            }
        }
    }
}