ohos-utilset

ohos-utilset — это набор полезных функций, которые помогут вам сэкономить время. Существует множество способов реализации метода, и мы часто тратим своё драгоценное время на поиск и тестирование этих методов. Некоторые из них работают, а некоторые нет. Поэтому мы собрали, протестировали и доработали методы, чтобы избавить вас от необходимости искать фрагменты кода.

Что включает в себя ohos-utilset:

• DeviceUtils:
  • определяет, является ли устройство мобильным телефоном;
  • определяет, есть ли у телефона возможность отправлять SMS.
• AbilityUtils:
  • очищает экран и поддерживает его включённым;
  • проверяет, установлен ли указанный пользователем пакет;
  • получает информацию об основном имени пакета активности и имени класса.
• NetworkUtils:
  • предоставляет слушателей, которые уведомляют об изменении состояния Wi-Fi, получении вызова или подключении к Wi-Fi/мобильной сети;
  • проверяет, включён ли Wi-Fi и подключён ли он;
  • проверяет подключение мобильной сети (3G/4G);
  • получает IP-адрес в формате v4 или v6.
• DiskUtils:
  • получает путь к внешнему хранилищу для кэширования;
  • получает путь к внешнему хранилищу для временных файлов;
  • получает путь карты MicroSD.
• CipherUtils:
  • предлагает простые криптографические методы на основе AES.
• StringUtils:
  • обеспечивает методы сжатия и распаковки строк.
• SystemUtils:
  • проверяет, рутован ли девайс;
  • подсчитывает количество процессоров (точнее, количество ядер).

Инструкции по использованию

Для примера приложения требуются следующие разрешения:

ohos.permission.GET_WIFI_INFO
ohos.permission.GET_TELEPHONY_STATE
ohos.permission.GET_NETWORK_INFO

DeviceUtils:

Получение типа лаунчера:

String launcher = String.valueOf(LauncherTypeDetector.getType(/* Pass Context*/));

Получение типа устройства:

DeviceTypeDetector deviceTypeDetector = new DeviceTypeDetector();
String device = String.valueOf(deviceTypeDetector.getDeviceType(/* Pass Context*/));

AbilityUtils:

Держать экран включённым:

ScreenUtils.setScreenOn(/* Pass Ability*/);

Очистить экран:

ScreenUtils.clearScreenOn(/* Pass Ability*/);

Проверка установленного пакета:

boolean isPackageInstalled = AbilityUtils.isPackageInstalled(/* Pass Context*/, /* Pass Bundlename*/);

Получение основного имени пакета способности:

String value = AbilityUtils.getBaseAbilityPackageName(/* Pass Context*/);

Получение имени класса основной способности:

String value = AbilityUtils.getBaseAbilityClassName(/* Pass Context*/);

Получение верхнего имени пакета способности:

String value = AbilityUtils.getTopAbilityPackageName(/* Pass Context*/);

Получение имени класса верхней способности:

String value =  AbilityUtils.getTopAbilityClassName(/* Pass Context*/);

Проверка статуса верхней способности:

boolean value = AbilityUtils.isTopApplication(/* Pass Context*/);

Проверка переднего плана контекста:

boolean value = AbilityUtils.isContextForeground(/* Pass Context*/);

NetworkUtils:

Определение статуса подключения Wi-Fi:

NetworkMonitor networkUtils = NetworkMonitor.getInstance(/* Pass Context*/);
boolean value = networkUtils.isWifiConnected();

Определение статуса включения Wi-Fi:

NetworkMonitor networkUtils = NetworkMonitor.getInstance(/* Pass Context*/);
boolean value = networkUtils.isWifiEnabled();

Определение статуса подключения мобильной сети:

NetworkMonitor networkUtils = NetworkMonitor.getInstance(/* Pass Context*/);
boolean value = networkUtils.isMobileConnected();

Определение состояния включения/выключения мобильной сети:

NetworkMonitor networkUtils = NetworkMonitor.getInstance(/* Pass Context*/);
boolean value = networkUtils.getMobileState();

Определение текущего статуса подключения к сети:

NetworkMonitor networkUtils = NetworkMonitor.getInstance(/* Pass Context*/);
boolean value = networkUtils.isNetworkConnected();

Определение статуса режима полёта:

NetworkMonitor networkUtils = NetworkMonitor.getInstance(/* Pass Context*/);
boolean value = networkUtils.isAirplaneModeOn();

Определение статуса SIM-карты:

NetworkMonitor networkUtils = NetworkMonitor.getInstance(/* Pass Context*/);
boolean value = networkUtils.getSimState();

Определение предыдущего статуса подключения Wi-Fi: NetworkMonitor

Получение NetworkMonitor:

NetworkMonitor networkUtils = NetworkMonitor.getInstance(/ Pass Context*/);*

Определение, было ли ранее подключено к Wi-Fi:

boolean value = networkUtils.getWifiConnectedPreviously();

Получение IPv6 и IPv4 на основе значения boolean (True/False) соответственно

Получение NetworkMonitor:

NetworkMonitor networkUtils = NetworkMonitor.getInstance(/ Pass Context*/);*

Получение строки с IP-адресом:

String value = networkUtils.getIpAddress(false);

Получение MAC-адреса WiFi-адаптера

Получение NetworkMonitor:

NetworkMonitor networkUtils = NetworkMonitor.getInstance(/ Pass Context*/);*

Получение строки с MAC-адресом:

String value = networkUtils.getWifiMacAddress();

DiskUtils

Определение статуса подключения внешнего хранилища

Определение статуса подключения внешнего хранилища:

boolean value = DiskUtils.isExternalStorageMounted();

Получение имени каталога для сохранения данных кэша во внешнем хранилище

Получение имени каталога:

String directory = DiskUtils.getExternalDirPath(/ Pass Context*/);*

Получение имени временного каталога для сохранения временных файлов во внешнем хранилище

Получение имени временного каталога:

String directory = DiskUtils.getExternalTemporaryDirPath(/ Pass Context*/);*

Получение корневого каталога внешнего хранилища

Получение корневого каталога:

String directory = DiskUtils.getExternalContextRootDir(/ Pass Context*/);*

CipherUtils

Выполнение шифрования

Создание CipherUtils:

CipherUtils cipherUtils = new CipherUtils();

Выполнение шифрования:

cipherUtils.encrypt(/ Pass seed(key) for encryption*/, /* Pass value to encrypt*/);*

Выполнение дешифрования

Создание CipherUtils:

CipherUtils cipherUtils = new CipherUtils();

Выполнение дешифрования:

cipherUtils.decrypt(/ Pass seed(key) corresponding to the encrypted value*/, /* Pass encrypted value*/);*

StringUtils

Сжатие строки

Сжатие строки:

String compressedString = CompressUtils.compressString(/ Pass string to compress*/);*

SystemUtils

Получение количества процессоров

Получение количества процессоров:

int processorNumber = SystemUtils.getProcessorNumbers();

Проверка статуса рутованного устройства

Проверка статуса рутованного устройства:

boolean value = SystemUtils.isRooted();

# Инструкции по установке

1. Для использования модуля ohos-utilset в примере приложения добавьте следующую зависимость библиотеки для генерации hap/utilset.har.

Измените entry build.gradle следующим образом:

dependencies {
    implementation project(path: ':utilset')
    testImplementation 'junit:junit:4.12'
    testImplementation 'pl.pragmatists:JUnitParams:1.1.1'
}

2. Для использования ohos-utilset в отдельном приложении добавьте «utilset.har» в папку libs модуля «entry».

Измените entry build.gradle следующим образом:

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])
}

3. Для использования ohos-utilset из удалённого репозитория в отдельном приложении добавьте следующую зависимость в «entry» build.gradle.

Измените entry build.gradle следующим образом:

dependencies {
    implementation 'io.openharmony.tpc.thirdlib:ohos-utilset:1.0.1'
}

# Лицензия

Copyright 2013 Navercorp

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.