OSCHINA-MIRROR/jenly1314-GuidePage

GuidePage для Android — это приложение, приветственное руководство. Обычно используется в сценариях первого открытия приложения. Через руководство можно получить обзор функций приложения и другую соответствующую информацию.

Функции:

цепочечный вызов, простой в использовании;
настраиваемая конфигурация, отвечающая различным потребностям.

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

GIF.gif

Введение:

Maven:

<dependency>
  <groupId>com.king.guide</groupId>
  <artifactId>guidepage</artifactId>
  <version>1.0.0</version>
  <type>pom</type>
</dependency>

Gradle:

//AndroidX
implementation 'com.king.guide:guidepage:1.0.0'

Lvy:

<dependency org='com.king.guide' name='guidepage' rev='1.0.0'>
  <artifact name='$AID' ext='pom'></artifact>
</dependency>

Если Gradle не может скомпилироваться, вы можете добавить следующее в Project build.gradle (или использовать GitPack для компиляции):

allprojects {
    repositories {
        //...
        maven { url 'https://dl.bintray.com/jenly/maven' }
    }
}

Пример:

Код примера:

// Простой пример вызова
GuidePage.load(intArrayOf(R.drawable.guide_page_1, R.drawable.guide_page_2, R.drawable.guide_page_3, R.drawable.guide_page_4))
.pageDoneDrawableResource(R.drawable.btn_done)
.start(this) // Activity или Fragment

// Пример вызова в Demo
GuidePage.load(intArrayOf(R.drawable.guide_page_1, R.drawable.guide_page_2, R.drawable.guide_page_3, R.drawable.guide_page_4))
.pageDoneDrawableResource(R.drawable.btn_done)
// .indicatorDrawableResource(R.drawable.indicator_radius)
// .indicatorSize(this, 6f) // По умолчанию 5dp
.showSkip(v.id == R.id.btn1) // Отображать ли «пропустить»
.lastPageHideSkip(true) // Скрывать ли «пропустить» на последней странице
.onGuidePageChangeCallback(object : GuidePage.OnGuidePageChangeCallback { // Обратный вызов при изменении страницы руководства

override fun onPageDone(skip: Boolean) {
    // TODO Когда нажать «Готово» (немедленно испытать) или «Пропустить» в правом верхнем углу, вызвать этот метод обратного вызова.
    // Здесь вы можете выполнить свою логику, например, перейти на главную страницу приложения или страницу входа
    if (skip) {
        Toast.makeText(this@MainActivity, "Пропустить", Toast.LENGTH_SHORT).show()
    } else {
        Toast.makeText(this@MainActivity, "Немедленно испытать", Toast.LENGTH_SHORT).show()
    }
})
.start(this) // Активность или фрагмент

Описание:

С помощью GuidePage можно выполнить некоторые основные требования к цепочке вызовов.

Если предоставленная GuidePage конфигурация не соответствует требованиям, можно настроить конфигурацию, используя способ именования ресурсов, который совпадает с ресурсами, такими как dimens и styles.

Для получения дополнительной информации об использовании см. примеры использования исходного кода в приложении app.

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

v1.0.0: 2019-12-24

Начальная версия GuidePage

Пожертвование:

Если вам нравится GuidePage или вы считаете, что GuidePage помог вам, вы можете поддержать его, поставив звезду. Ваша поддержка — моя мотивация, спасибо! Вы также можете отсканировать следующий QR-код, чтобы поддержать автора чашкой кофе:

<div>
    <img src="https://jenly1314.github.io/image/pay/wxpay.png" width="280" heght="350">
    <img src="https://jenly1314.github.io/image/pay/alipay.png" width="280" heght="350">
    <img src="https://jenly1314.github.io/image/pay/qqpay.png" width="280" heght="350">
    <img src="https://jenly1314.github.io/image/alipay_red_envelopes.jpg" width="233" heght="350">
</div>

Обо мне:

Name: Jenly Email: jenly1314@gmail.com