PingPlacePicker 开源项目教程

PingPlacePicker 开源项目教程

pingplacepickerAn almost plug and play replacement for Google's Place Picker项目地址:https://gitcode.com/gh_mirrors/pi/pingplacepicker

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

PingPlacePicker 项目的目录结构如下：

pingplacepicker/
├── gradle/
│   └── wrapper/
├── images/
├── library/
├── sample/
├── .gitignore
├── LICENSE
├── README.md
├── build.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
├── jitpack.yml
└── settings.gradle

目录介绍

• gradle/wrapper/: 包含 Gradle 包装器的文件，用于确保项目使用特定版本的 Gradle。
• images/: 可能包含项目相关的图片资源。
• library/: 项目的核心库代码。
• sample/: 示例应用程序代码，展示如何使用 library。
• .gitignore: Git 忽略文件，指定哪些文件和目录不应被版本控制。
• LICENSE: 项目的许可证文件，本项目使用 Apache-2.0 许可证。
• README.md: 项目的主要说明文档。
• build.gradle: 项目的构建脚本。
• gradle.properties: Gradle 属性文件，包含构建配置的属性。
• gradlew 和 gradlew.bat: Gradle 包装脚本，用于在不同操作系统上运行 Gradle。
• jitpack.yml: JitPack 配置文件，用于构建和发布项目。
• settings.gradle: Gradle 设置文件，包含项目的模块配置。

2. 项目的启动文件介绍

项目的启动文件主要位于 sample/ 目录下，因为 sample 目录包含了示例应用程序的代码。以下是 sample/ 目录中的关键文件：

sample/
├── src/
│   └── main/
│       ├── java/
│       │   └── com/
│       │       └── rtchagas/
│       │           └── pingplacepicker/
│       │               └── MainActivity.java
│       └── res/
│           ├── layout/
│           │   └── activity_main.xml
│           └── values/
│               └── strings.xml

启动文件介绍

• MainActivity.java: 示例应用程序的主活动，包含启动 Place Picker 的逻辑。
• activity_main.xml: 主活动的布局文件。
• strings.xml: 包含应用程序的字符串资源。

3. 项目的配置文件介绍

项目的配置文件主要位于项目根目录下，以下是关键配置文件的介绍：

• build.gradle: 项目的构建脚本，包含依赖管理、插件应用等配置。
• gradle.properties: Gradle 属性文件，包含构建配置的属性，如版本号、编译选项等。
• settings.gradle: Gradle 设置文件，包含项目的模块配置，如包含哪些子项目。
• jitpack.yml: JitPack 配置文件，用于构建和发布项目，包含构建步骤和依赖配置。

build.gradle 示例

plugins {
    id 'com.android.library'
    id 'kotlin-android'
}

android {
    compileSdkVersion 30
    defaultConfig {
        minSdkVersion 16
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'com.google.android.gms:play-services-maps:17.0.0'
    implementation 'com.google.android.gms:play-services-places:17.0.0'
    implementation 'com.google.android.libraries.places:places:2.4.0'
}

gradle.properties 示例

org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
android.useAndroidX=true
android.enableJetifier=true

settings.gradle 示例

include ':library', ':sample'

jitpack.yml 示例

jdk:
  - openjdk8
before_install:

pingplacepickerAn almost plug and play replacement for Google's Place Picker项目地址:https://gitcode.com/gh_mirrors/pi/pingplacepicker