BonjourBrowser开源项目教程

1. 项目目录结构及介绍

BonjourBrowser/
├── app/                      # 应用程序的主要代码目录
│   ├── src/                  # 源代码目录
│   │   ├── main/             # 主代码目录
│   │   │   ├── java/         # Java源代码文件
│   │   │   ├── res/          # 资源目录，包含布局、图片等
│   │   │   ├── assets/       # 资源目录，用于存放非编译资源
│   │   │   └── AndroidManifest.xml # 应用程序的配置文件
│   │   └── build.gradle      # 模块的构建脚本
│   └── build/                # 编译生成的文件目录
├── gradle/                   # Gradle脚本目录
│   ├── wrapper/              # Gradle包装器配置
│   └── build.gradle          # 项目级构建脚本
├── .gitignore                # Git忽略文件配置
├── .gitmodules               # Git子模块配置
├── LICENSE                   # 项目许可证信息
├── README.md                 # 项目说明文件
├── build.gradle              # 项目根目录的构建脚本
└── settings.gradle           # 项目设置脚本

• app/: 应用程序的主要代码目录，包含项目的源代码、资源以及构建配置。
• src/: 源代码目录，包含所有Java代码、资源文件以及应用的配置文件。
• res/: 资源目录，包含应用的布局文件、图片、字符串等资源。
• assets/: 存放非编译资源的目录，例如HTML文件、JavaScript文件等。
• AndroidManifest.xml: 应用程序的配置文件，定义了应用的基本信息和权限要求。
• build.gradle: 模块级别的构建脚本，定义了如何编译和打包应用。
• gradle/: 存放Gradle相关文件的目录。
• .gitignore: 指定Git应该忽略的文件和目录。
• .gitmodules: 如果项目包含子模块，此文件用于配置子模块。
• LICENSE: 项目使用的许可证信息。
• README.md: 项目说明文件，通常包含项目描述、功能、使用方法等。
• settings.gradle: 项目设置脚本，用于配置项目级的多模块构建。

2. 项目的启动文件介绍

在app/src/main/目录下，AndroidManifest.xml是应用的启动文件。它定义了应用的基本信息和入口点。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.bonjourbrowser">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.AppCompat.Light.NoActionBar">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

这个文件中定义了应用的包名、图标、标签以及主题。最重要的是它定义了MainActivity作为应用的启动活动。

3. 项目的配置文件介绍

项目的主要配置文件是位于根目录下的build.gradle文件，以及app目录下的build.gradle文件。

根目录下的build.gradle:

// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:3.5.3"
    }
}

allprojects {
    repositories {
        google()
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

这个文件定义了项目级的依赖和仓库配置。

app目录下的build.gradle:

plugins {
    id 'com.android.application'
}

android {
    compileSdkVersion 29
    defaultConfig {
        applicationId "com.example.bonjourbrowser"
        minSdkVersion 15
        targetSdkVersion 29
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.code.gson:gson:2.8.6'
    // Add the following dependencies for the BonjourBrowser functionality
    implementation 'com.github.druk:rx dnssd:0.9.12'
    implementation 'com.squareup.okhttp3:okhttp:4.9.0'
}

这个文件定义了应用的编译SDK版本、最小和目标SDK版本、应用ID、版本号等信息。同时，它也配置了应用的构建类型和依赖项。