UltraViewPager 项目教程

1、项目的目录结构及介绍

UltraViewPager 项目的目录结构如下：

UltraViewPager/
├── README.md
├── build.gradle
├── gradle.properties
├── settings.gradle
├── ultraviewpager/
│   ├── build.gradle
│   ├── proguard-rules.pro
│   ├── src/
│   │   ├── main/
│   │   │   ├── AndroidManifest.xml
│   │   │   ├── java/
│   │   │   │   └── com/
│   │   │   │       └── tmall/
│   │   │   │           └── ultraviewpager/
│   │   │   │               ├── UltraViewPager.java
│   │   │   │               ├── UltraViewPagerAdapter.java
│   │   │   │               ├── UltraViewPagerView.java
│   │   │   │               └── ...
│   │   │   └── res/
│   │   │       ├── drawable/
│   │   │       ├── layout/
│   │   │       ├── values/
│   │   │       └── ...
│   │   └── test/
│   │       └── java/
│   │           └── com/
│   │               └── tmall/
│   │                   └── ultraviewpager/
│   │                       └── ...
│   └── ...
└── ...

目录结构介绍

• README.md: 项目说明文档。
• build.gradle: 项目的根构建文件。
• gradle.properties: Gradle 配置文件。
• settings.gradle: 项目设置文件。
• ultraviewpager/: UltraViewPager 模块目录。
  • build.gradle: UltraViewPager 模块的构建文件。
  • proguard-rules.pro: ProGuard 规则文件。
  • src/: 源代码目录。
    • main/: 主源代码目录。
      • AndroidManifest.xml: 模块的清单文件。
      • java/: Java 源代码目录。
        • com/tmall/ultraviewpager/: UltraViewPager 的主要 Java 文件目录。
          • UltraViewPager.java: UltraViewPager 的主类文件。
          • UltraViewPagerAdapter.java: UltraViewPager 的适配器类文件。
          • UltraViewPagerView.java: UltraViewPager 的视图类文件。
          • ...
      • res/: 资源文件目录。
        • drawable/: 可绘制资源目录。
        • layout/: 布局文件目录。
        • values/: 值资源目录。
        • ...
    • test/: 测试代码目录。
      • java/: 测试 Java 源代码目录。
        • com/tmall/ultraviewpager/: 测试类文件目录。
          • ...

2、项目的启动文件介绍

UltraViewPager 项目的启动文件主要是 UltraViewPager.java，位于 ultraviewpager/src/main/java/com/tmall/ultraviewpager/UltraViewPager.java。

UltraViewPager.java 介绍

UltraViewPager.java 是 UltraViewPager 的核心类，继承自 RelativeLayout，封装了 ViewPager 和 indicator 的功能。它提供了以下主要功能：

• 支持横向滑动和纵向滑动。
• 支持一屏内显示多页。
• 支持循环滚动。
• 支持定时滚动，计时器使用 Handler 实现。
• 支持设置 ViewPager 的最大宽高。
• 内置 indicator，支持圆点和 Icon。
• 内置两种页面切换动效。

3、项目的配置文件介绍

UltraViewPager 项目的配置文件主要包括 build.gradle 和 AndroidManifest.xml。

build.gradle 介绍

build.gradle 文件位于项目的根目录和 ultraviewpager 模块目录下。

根目录下的 build.gradle

// 根目录下的 build.gradle
buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:4.1.0'
    }
}

allprojects {
    repositories {
        google()