SmsForwarder 项目教程

2026-01-16 09:26:57作者：江焘钦

短信转发器——监控Android手机短信、来电、APP通知，并根据指定规则转发到其他手机：钉钉群自定义机器人、钉钉企业内机器人、企业微信群机器人、飞书机器人、企业微信应用消息、邮箱、bark、webhook、Telegram机器人、Server酱、PushPlus、手机短信等。包括主动控制服务端与客户端，让你轻松远程发短信、查短信、查通话、查话簿、查电量等。（V3.0 新增）PS.这个APK主要是学习与自用，如有BUG请提ISSUE，同时欢迎大家提PR指正

项目地址：https://gitcode.com/gh_mirrors/sms/SmsForwarder

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

SmsForwarder 项目的目录结构如下：

SmsForwarder/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/
│   │   │   │   ├── com/
│   │   │   │   │   ├── pppscn/
│   │   │   │   │   │   ├── smsforwarder/
│   │   │   │   │   │   │   ├── MainActivity.kt
│   │   │   │   │   │   │   ├── ...
│   │   │   ├── res/
│   │   │   │   ├── layout/
│   │   │   │   │   ├── activity_main.xml
│   │   │   │   │   ├── ...
│   │   │   │   ├── values/
│   │   │   │   │   ├── strings.xml
│   │   │   │   │   ├── ...
│   │   │   ├── AndroidManifest.xml
│   │   ├── test/
│   │   ├── androidTest/
├── build.gradle
├── settings.gradle
├── README.md
├── LICENSE

目录结构介绍

app/src/main/java/com/pppscn/smsforwarder/: 包含项目的所有 Kotlin 源代码文件。
app/src/main/res/: 包含项目的资源文件，如布局文件 (layout/)、字符串资源 (values/) 等。
app/src/main/AndroidManifest.xml: 项目的清单文件，定义了应用的基本属性和组件。
build.gradle: 项目的构建脚本。
settings.gradle: 项目的设置文件。
README.md: 项目的说明文档。
LICENSE: 项目的许可证文件。

2. 项目的启动文件介绍

项目的启动文件是 MainActivity.kt，位于 app/src/main/java/com/pppscn/smsforwarder/ 目录下。

MainActivity.kt

MainActivity.kt 是应用的主活动，负责初始化用户界面和处理用户交互。以下是 MainActivity.kt 的基本结构：

package com.pppscn.smsforwarder

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        // 初始化代码
    }

    // 其他方法
}

功能介绍

onCreate(savedInstanceState: Bundle?): 活动创建时调用，设置布局文件并初始化界面。
其他方法：处理用户交互和业务逻辑。

3. 项目的配置文件介绍

项目的配置文件主要包括 build.gradle 和 AndroidManifest.xml。

build.gradle

build.gradle 文件位于项目根目录下，用于配置项目的构建脚本。以下是 build.gradle 的基本结构：

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

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "com.pppscn.smsforwarder"
        minSdkVersion 21
        targetSdkVersion 30
        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 "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'androidx.core:core-ktx:1.3.2'
    implementation 'com.google.android.material:material:1.3.0'
    implementation 'androidx.constraintlayout:constraint