FragmentStack 开源项目教程

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

FragmentStack 项目的目录结构如下：

fragmentstack/
├── app/
│   ├── build.gradle
│   └── src/
│       └── main/
│           ├── java/
│           │   └── com/
│           │       └── simonvt/
│           │           └── fragmentstack/
│           │               ├── ExampleActivity.java
│           │               ├── ExampleFragment.java
│           │               └── ...
│           └── res/
│               ├── layout/
│               │   └── activity_example.xml
│               └── ...
├── fragmentstack/
│   ├── build.gradle
│   └── src/
│       └── main/
│           ├── java/
│           │   └── com/
│           │       └── simonvt/
│           │           └── fragmentstack/
│           │               ├── FragmentStack.java
│           │               ├── FragmentStackManager.java
│           │               └── ...
│           └── res/
│               └── ...
├── build.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
├── settings.gradle
└── README.md

目录结构介绍

• app/: 包含示例应用的代码和资源文件。

  • build.gradle: 应用模块的构建脚本。
  • src/main/java/com/simonvt/fragmentstack/: 包含示例应用的主要Java代码。
    • ExampleActivity.java: 示例应用的主Activity。
    • ExampleFragment.java: 示例应用的Fragment。
  • src/main/res/: 包含示例应用的资源文件，如布局文件等。

• fragmentstack/: 包含FragmentStack库的代码和资源文件。

  • build.gradle: 库模块的构建脚本。
  • src/main/java/com/simonvt/fragmentstack/: 包含FragmentStack库的主要Java代码。
    • FragmentStack.java: FragmentStack库的核心类。
    • FragmentStackManager.java: FragmentStack的管理类。
  • src/main/res/: 包含FragmentStack库的资源文件。

• build.gradle: 项目的根构建脚本。

• gradle.properties: Gradle配置属性文件。

• gradlew 和 gradlew.bat: Gradle包装器脚本。

• settings.gradle: 项目设置文件。

• README.md: 项目说明文档。

2. 项目的启动文件介绍

ExampleActivity.java

ExampleActivity.java 是示例应用的主Activity，负责初始化和启动FragmentStack。

package com.simonvt.fragmentstack;

import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;

public class ExampleActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_example);

        if (savedInstanceState == null) {
            getSupportFragmentManager().beginTransaction()
                .replace(R.id.container, new ExampleFragment())
                .commit();
        }
    }
}

ExampleFragment.java

ExampleFragment.java 是示例应用的Fragment，展示了如何使用FragmentStack。

package com.simonvt.fragmentstack;

import android.os.Bundle;
import androidx.fragment.app.Fragment;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;

public class ExampleFragment extends Fragment {
    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        return inflater.inflate(R.layout.fragment_example, container, false);
    }
}

3. 项目的配置文件介绍

build.gradle (根目录)

根目录下的 build.gradle 文件包含了整个项目的构建配置。

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.0'
        // NOTE