DraggableGridView 使用指南

DraggableGridView 使用指南

DraggableGridView A drag-and-drop scrolling grid view for Android 项目地址: https://gitcode.com/gh_mirrors/dr/DraggableGridView

项目目录结构及介绍

DraggableGridView 是一个专为Android设计的拖放式可滚动网格视图。以下是该项目的基本目录结构及其组成部分的简介：

DraggableGridView/
├── bin/                     # 编译后的类文件和资源文件存放目录（已过时，现代构建系统如Gradle不常用）
├── gen/                     # 自动生成的代码文件目录，通常包括R.java等（在新版本Android Studio中也被移至其他机制管理）
├── libs/                    # 包含核心库jar文件，即DraggableGridView.jar，用于添加到项目依赖中
├── res/                     # 资源文件夹，存储布局、图片、颜色值等资源
│   ├── drawable/...
│   ├── layout/               # 布局文件，例如示例布局可能在此
│   └── ...
├── src/                      # 源码目录
│   └── com/animoto/android/  # 主要的包，包含DraggableGridView类及其他相关辅助类
│       ├── views/             # 视图组件，包括DraggableGridView的实现
│       └── ...
├── .classpath                # Eclipse项目类路径配置文件（非必需，适用于Eclipse时代的项目）
├── .gitignore               # Git忽略文件列表
├── project.properties        # 古老的Android项目属性文件（当前多被build.gradle替代）
├── AndroidManifest.xml      # Android应用的主要配置文件，定义应用基本信息、权限等
├── LICENSE.txt              # 许可证文件，说明了项目的授权方式（Apache License 2.0）
└── README.rdoc              # 项目快速入门和重要信息的文档

项目的启动文件介绍

启动应用时，重点在于集成DraggableGridView到您的活动(Activity)中。虽然具体启动文件名未直接给出，但通常您会在一个类似DraggableGridViewSampleActivity.java的活动中找到启动逻辑。基本步骤包括：

• 导入类：首先，在您的活动文件顶部导入必要的类。

  import com.animoto.android.views.DraggableGridView;
  

• XML布局：在res/layout/main.xml或其他相应的布局文件中添加DraggableGridView。

  <com.animoto.android.views.DraggableGridView
      android:id="@+id/dgv"
      android:layout_height="fill_parent"
      android:layout_width="fill_parent"
      android:layout_alignParentTop="true"
      android:layout_alignParentLeft="true" />
  

• 初始化与使用： 在活动的onCreate方法中，通过ID获取DraggableGridView的实例，并准备进行交互。

  public class DraggableGridViewSampleActivity extends Activity {
      DraggableGridView dgv;
  
      @Override
      protected void onCreate(Bundle savedInstanceState) {
          super.onCreate(savedInstanceState);
          setContentView(R.layout.main);
         .dgv = findViewById(R.id.dgv); // 获取DraggableGridView实例
          // 之后可以开始向grid添加视图或设置监听器等操作
      }
  }
  

项目的配置文件介绍

AndroidManifest.xml

这是Android应用的核心配置文件，定义了应用的基本信息，如应用的包名、允许使用的权限、默认启动活动等。对于DraggableGridView项目而言，它确保了项目能够作为一个合法的Android应用程序运行，并声明了所有必要的组件和权限。

其他配置

由于DraggableGridView是作为库项目设计的，主要的“配置”除了上述AndroidManifest.xml外，更多地体现在代码级别的依赖管理和初始化上，如导入库、初始化视图等。传统上，若要将此库集成到旧版项目中，可能需要手动处理.jar文件的引入，但在现代Android开发中，这通常通过Gradle或Maven等构建工具的依赖管理完成，而非直接在项目中包含.jar和手动管理。

请注意，实际操作中，当代Android开发首选的方式是使用Gradle脚本进行依赖管理，而该教程基于给定的原始仓库结构进行描述。在现代实践中，会推荐将此类库依赖转化为 Gradle 引用，而不是直接管理.jar文件。

DraggableGridView A drag-and-drop scrolling grid view for Android 项目地址: https://gitcode.com/gh_mirrors/dr/DraggableGridView