CityPicker 开源项目使用教程

CityPicker 开源项目使用教程

citypickercitypicker城市选择器，详细的省市区地址信息，支持仿iOS滚轮实现，仿京东样式，一级或者三级列表展示方式。项目地址:https://gitcode.com/gh_mirrors/ci/citypicker

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

CityPicker 项目的目录结构如下：

citypicker/
├── app/
│   ├── build.gradle
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/
│   │   │   │   └── com/
│   │   │   │       └── crazyandcoder/
│   │   │   │           └── citypicker/
│   │   │   │               ├── MainActivity.java
│   │   │   │               └── ...
│   │   │   ├── res/
│   │   │   │   ├── layout/
│   │   │   │   ├── values/
│   │   │   │   └── ...
│   │   │   └── AndroidManifest.xml
│   │   └── ...
│   └── ...
├── citypickerview/
│   ├── build.gradle
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/
│   │   │   │   └── com/
│   │   │   │       └── crazyandcoder/
│   │   │   │           └── citypickerview/
│   │   │   │               ├── adapter/
│   │   │   │               ├── model/
│   │   │   │               ├── view/
│   │   │   │               └── ...
│   │   │   ├── res/
│   │   │   │   ├── drawable/
│   │   │   │   ├── layout/
│   │   │   │   ├── values/
│   │   │   │   └── ...
│   │   │   └── AndroidManifest.xml
│   │   └── ...
│   └── ...
├── build.gradle
├── settings.gradle
└── ...

目录结构介绍

• app/: 主应用程序模块，包含主要的业务逻辑和界面。

  • src/main/java/com/crazyandcoder/citypicker/: 主应用程序的 Java 源代码。
  • src/main/res/: 资源文件，包括布局、字符串、图片等。
  • AndroidManifest.xml: 应用程序的清单文件。

• citypickerview/: CityPicker 库模块，包含城市选择器的核心功能。

  • src/main/java/com/crazyandcoder/citypickerview/: 城市选择器的 Java 源代码。
  • src/main/res/: 城市选择器的资源文件。
  • AndroidManifest.xml: 库模块的清单文件。

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

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

2. 项目的启动文件介绍

CityPicker 项目的启动文件是 app/src/main/java/com/crazyandcoder/citypicker/MainActivity.java。

MainActivity.java

package com.crazyandcoder.citypicker;

import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import com.crazyandcoder.citypickerview.CityPickerView;

public class MainActivity extends AppCompatActivity {

    private CityPickerView mCityPickerView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mCityPickerView = new CityPickerView();
        mCityPickerView.init(this);
    }
}

启动文件介绍

• MainActivity 继承自 AppCompatActivity，是应用程序的主活动。
• 在 onCreate 方法中，设置了布局文件 activity_main。
• 初始化了 CityPickerView 实例，并调用 init 方法进行初始化。

3. 项目的配置文件介绍

CityPicker 项目的配置文件主要包括 app/build.gradle 和 citypickerview/build.gradle。

app/build.gradle

apply plugin: 'com.android.application'

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "com.crazyandcoder.citypicker"
        minSdkVersion 16
        targetSdkVersion 30
       

citypickercitypicker城市选择器，详细的省市区地址信息，支持仿iOS滚轮实现，仿京东样式，一级或者三级列表展示方式。项目地址:https://gitcode.com/gh_mirrors/ci/citypicker