Проект перенесён на GitHub

https://github.com/pocketdigi/PLib

PLib

PLib — это Android-библиотека для разработки приложений, которая объединяет популярные open-source библиотеки и некоторые утилиты (Util). Она помогает разработчикам быстрее создавать приложения. Поддерживается только Android Studio.

Начиная с версии 1.6, библиотека больше не использует Volley, а для сетевых запросов применяется OKHttp. Это обеспечивает простоту и эффективность использования.

Интегрированные open-source библиотеки:

1. AndroidAnnotations;
2. Gson;
3. EventBus;
4. Fresco;
5. OKHttp3.

Функции:

• OKHttp3 позволяет легко реализовать post и get запросы, а также загружать и скачивать файлы с помощью нескольких строк кода;
• SharedPreference предоставляет возможность сохранять и читать настройки с помощью одной строки кода;
• Toast предоставляет готовые решения для отображения сообщений;
• Log предоставляет инструменты для логирования;
• другие утилиты: MD5, DES, обработка дат, строк, изображений, проверка сети, обнаружение первого запуска, сравнение версий и т. д.;
• CarouselViewPager — карусель с изображениями;
• BoldTextView — текст с выделением жирным шрифтом.

Есть два способа использования PLib:

1. Скачать демонстрационный проект:

— обратитесь к демонстрационному проекту, импортируйте его в Android Studio, перестройте проект, измените имя пакета и используйте его напрямую; — демонстрационный проект включает следующие функции: * PageManager — использование одностраничной архитектуры с фрагментами и управление через PageManger; * HTTP-интерфейс для получения данных и использование Android DataBinding Framework; * интеграция с системой статистики AdMob; * другие небольшие функции.

2. Добавить как подмодуль в существующий проект:

— перейдите в корневой каталог проекта и добавьте подмодуль; git submodule add -b v1.5 https://git.oschina.net/pocketdigi/PLib.git plib; — внесите изменения в файл build.gradle проекта:

// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.1.0'
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

— внесите изменения в файл settings.gradle проекта: include ':app', ':plib'; — добавьте модуль plib в проект; — внесите изменения в файл build.gradle модуля app:

apply plugin: 'com.neenbedankt.android-apt'
def AAVersion = '4.0.0'
dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile project(':plib')
    apt "org.androidannotations:androidannotations:$AAVersion"
    compile 'com.android.support:appcompat-v7:23.2.1'
    compile 'com.android.support:cardview-v7:23.2.1'
    compile 'com.android.support:recyclerview-v7:23.2.1'
}

apt {
    arguments {
        resourcePackageName android.defaultConfig.applicationId
        androidManifestFile variant.outputs[0].processResources.manifestFile
    }
}

После завершения этих шагов можно использовать стандартные аннотации AndroidAnnotations для разработки. Приложение наследуется от PApplication, активность — от PFragmentActivity.

Сетевые запросы

С версии 1.6 больше не используется Volley. Вместо этого сетевые запросы выполняются с использованием OKHttp.

GET: PRequest request=new PRequest<>("http://git.oschina.net/pocketdigi/PLib/raw/master/README.md", listener,String.class); PHttp.getInstance().addRequest(request);

listener — это экземпляр PResponseListener. Если тип PResponseListener — String, то строка возвращается без обработки. В противном случае объект преобразуется с помощью GSON.

POST: public static void post(PResponseListener listener) { PRequest request=new PRequest<>(PRequest.POST, API_PREFIX+"add", listener,String.class); request.addParam("p1","value1"); request.addParam("p2","value2"); PHttp.getInstance().addRequest(request);}

POST Json: public static void postObject(Person person,PResponseListener listener) { PRequest request=new PRequest<>(PRequest.POST, API_PREFIX+"add", listener,String.class); request.setPostObject(person); PHttp.getInstance().addRequest(request);}

Объект преобразуется в JSON и отправляется в теле запроса с помощью Gson.

Загрузка: public static PUploadRequest upload(String filePath,UploadListener listener) { PUploadRequest request=new PUploadRequest<>(API_PREFIX+"upload","file",filePath, listener,String.class); PHttp.getInstance().addRequest(request); return request;}

Скачивание: public static PDownFileRequest downloadFile(String url, String savePath, DownProgressListener listener) { PDownFileRequest pDownFileRequest = new PDownFileRequest(url, savePath,listener); PHttp.getInstance().addRequest(pDownFileRequest); return pDownFileRequest;} ###Часто используемые утилиты 1. Обертка SharedPreference
Используя SharedPreference, можно связать:
PreferenceManager.getDefaultManager().putBoolean(KEY1,Value1).putString(KEY2,Value2).commit();
Для сохранения данных необходимо вызвать метод commit() в конце. Поддерживается указание файла для сохранения.
2. Обертка Toast
После обёртки Toast его можно вызывать напрямую из не-UI потока:
PToast.show(message);
3. Обертка Log
Класс PLog поддерживает больше типов параметров. Например, тег Tag может принимать объект Object, при этом будет использоваться имя класса объекта как тега. Сообщение Message может содержать базовые типы данных.

Прочее
md5, DES, обработка даты, обработка строк, обработка изображений, проверка сети, проверка первого запуска и т. д.