Fragivity项目安装与使用指南

一、项目目录结构及介绍

Fragivity是一个旨在简化“单Activity+多Fragment”架构应用开发的库。其GitHub仓库遵循标准的Android开发目录结构。以下是关键部分的概述：

• src

  • main
    • java: 包含了核心库的源代码，主要包名通常为com.vitaviva.fragivity。这里封装了所有关于Fragment管理、生命周期控制以及导航逻辑的相关类。
    • res: 资源文件夹，可能包含了布局文件、字符串资源等，用于支持Fragment界面的展示。
    • AndroidManifest.xml: 应用的主配置文件，声明了必要的元数据，如权限、主题以及主Activity。

• build.gradle: 项目构建配置文件，指定了依赖项、插件版本以及其他编译设置。

• README.md: 快速入门和项目概览，对于新用户是了解项目特性和基本使用的入口点。

• LICENSE: 许可证文件，说明了软件的使用条款，通常是Apache、MIT或其他开源许可证。

二、项目的启动文件介绍

在Fragivity项目中，虽然没有一个单一定义为“启动文件”的文件，但关键的起点通常在于你的应用程序的主Activity。这个Activity应当继承自Fragivity提供的特定基类，这使得能够利用其特性。假设您有一个名为MainActivity的类，它可能会看起来类似于下面这样简化示例（实际代码取决于您的具体实现）：

import com.vitaviva.fragivity.FragivityCompatActivity

class MainActivity : FragivityCompatActivity() {
   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       setContentView(R.layout.activity_main)
       
       // 初始化导航图或者进行其他配置
       setupNavGraph()
   }
   
   // ... 其他配置和逻辑
}

这里的setupNavGraph()方法代表了初始化导航的逻辑，该逻辑可以根据Fragivity的推荐方式来配置您的Fragment导航路径。

三、项目的配置文件介绍

AndroidManifest.xml

此文件位于src/main目录下，是应用的核心配置文件。在这里，您会声明应用的默认主题，指定主Activity，申请运行时权限等。Fragivity的使用可能不会直接影响到此文件的基本结构，但是确保Activity正确声明且具备必要的属性（比如设置UI主题）是很重要的。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="your.package.name">
    
    <application
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme">
        
        <!-- 主Activity声明 -->
        <activity android:name=".MainActivity"
            android:launchMode="standard">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>
        
        <!-- 其他配置 -->
    </application>

</manifest>

build.gradle (Module)

在项目级别的build.gradle文件中，添加Fragivity的依赖是集成的关键步骤之一。虽然具体的依赖条目需要查看Fragivity的最新文档或JitPack页面，一般形式如下：

dependencies {
    implementation 'com.github.vitaviva:fragivity:latest.version'
}

请注意，latest.version应替换为实际的版本号，可以从项目的Release页面获取。

通过以上模块的介绍，您可以开始理解并逐步整合Fragivity到您的Android项目中，享受它带来的Fragment管理与生命周期优化的便利。