BaseUrlManager

Изображения:

1. Скачать: App-релиз.apk.
2. MavenCentral.
3. JCenter.
4. JitPack.
5. CI.
6. CircleCI.
7. API 16+.
8. Лицензия MIT.
9. Блог Jenly.
10. QQGroup.

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

Больше не нужно беспокоиться о необходимости создания нескольких пакетов для разных сред! Прощайте, хлопоты по настройке конфигураций для каждой среды!

В сочетании с RetrofitHelper динамическое изменение BaseUrl становится ещё более удобным.

GIF-демонстрация

Введение

Gradle

1. В файле build.gradle проекта добавьте удалённый репозиторий:

allprojects {
    repositories {
        //...
        mavenCentral()
    }
}

2. В файл build.gradle модуля добавьте зависимость:

//AndroidX версия
implementation 'com.github.jenly1314:base-url-manager:1.2.0'

Для версий, опубликованных ранее на JCenter, используйте следующий код:

//AndroidX версия
implementation 'com.king.base:base-url-manager:1.1.1'

//-----------------------v1.0.x и предыдущие версии
//AndroidX версия
implementation 'com.king.base:base-url-manager:1.0.1-androidx'

//Версия Android Support
implementation 'com.king.base:base-url-manager:1.0.1'

Пример

Пример интеграции (пример взят из приложения app):

Шаг 1. В вашем проекте в файле AndroidManifest.xml настройте глобальные параметры через meta-data:

<!-- В вашем проекте добавьте следующую конфигурацию -->
<activity android:name="com.king.base.baseurlmanager.BaseUrlManagerActivity"
    android:screenOrientation="portrait"
    android:theme="@style/BaseUrlManagerTheme"/>

Шаг 2. Инициализируйте BaseUrlManager в методе onCreate вашего приложения:

//Получите экземпляр BaseUrlManager (подходит для версии v1.1.x)
mBaseUrlManager = BaseUrlManager.getInstance();

//Получите экземпляр BaseUrlManager (подходит для старых версий v1.0.x)
mBaseUrlManager = new BaseUrlManager(this);

//Получите baseUrl
String baseUrl = mBaseUrlManager.getBaseUrl();

Шаг 3. Предоставьте динамическую конфигурацию BaseUrl через Intent для перехода к BaseUrlManagerActivity:

v.1.1.x новая версия:

BaseUrlManager.getInstance().startBaseUrlManager(this,SET_BASE_URL_REQUEST_CODE);

v1.0.x старая версия:

Intent intent = new Intent(this, BaseUrlManagerActivity.class);
//Заголовок экрана BaseUrlManager
//intent.putExtra(BaseUrlManagerActivity.KEY_TITLE,"Конфигурация BaseUrl");
//Переход к экрану BaseUrlManager
startActivityForResult(intent,SET_BASE_URL_REQUEST_CODE);

Шаг 4. После изменения конфигурации baseUrl получите новый baseUrl в методе onActivityResult Activity или Fragment:

//Способ 1: через BaseUrlManager получить baseUrl
String baseUrl = BaseUrlManager.getInstance().getBaseUrl();
//Способ 2: напрямую через data получить baseUrl
UrlInfo urlInfo = BaseUrlManager.parseActivityResult(data);
String baseUrl = urlInfo.getBaseUrl();

Дополнительные сведения об использовании см. в исходном коде приложения app или непосредственно в документации API (https://jenly1314.github.io/projects/BaseUrlManager/doc/).

История версий

v1.2.0: 2022-1-25 (с версии v1.2.0 публикуется на MavenCentral)

• Оптимизация деталей.

v1.1.1: 2021-1-28

• Поддержка длинного нажатия для копирования.

v1.1.0: 2020-12-4

• Введённая url поддерживает регулярные выражения.
• Последующие версии поддерживают только androidx, название версии больше не содержит обозначения androidx.

v1.0.1: 2019-7-5

• Удалено app_name из ресурсов strings.xml.
• Поддерживается получение информации о baseUrl без обновления данных, непосредственно через onActivityResult.

v1.0.0: 2019-6-11