Ruru开发者指南：扩展检测功能与自定义规则实现

Ruru开发者指南：扩展检测功能与自定义规则实现

【免费下载链接】RuruAn android sample app of detecting suspicious apps like magisk manager项目地址: https://gitcode.com/gh_mirrors/rur/Ruru

Ruru（GitHub加速计划）是一款强大的Android应用，专注于检测Magisk Manager等可疑应用。本文将为开发者提供一份详尽的指南，帮助你扩展Ruru的检测功能并实现自定义规则，让这款应用的安全防护能力更上一层楼。

核心检测框架解析

Ruru的检测功能基于一个灵活的框架构建，其核心是IDetector接口。这个接口定义了检测模块的基本规范，所有具体的检测实现都围绕它展开。

在项目中，IDetector接口位于library/src/main/java/icu/nullptr/applistdetector/IDetector.kt文件中。它是一个抽象类，为检测模块提供了基础结构。

abstract class IDetector(protected val context: Context) { // 检测逻辑的实现 abstract suspend fun detect(): Result // 检测结果的枚举类型 enum class Result { NOT_FOUND, FOUND, SUSPICIOUS, METHOD_UNAVAILABLE } }

Ruru已经实现了多种检测方式，如通过PackageManager API、系统命令、文件系统等。这些实现类都位于library/src/main/java/icu/nullptr/applistdetector/目录下，例如：

• PMConventionalAPIs.kt：使用常规的PackageManager API进行检测
• PMCommand.kt：通过执行pm命令来获取应用信息
• FileDetection.kt：文件系统检测

扩展检测功能的步骤

1. 创建新的检测类

要添加新的检测功能，首先需要创建一个新的类，继承自IDetector。这个类将实现具体的检测逻辑。

class CustomDetector(context: Context, override val name: String) : IDetector(context) { override suspend fun detect(): Result { // 实现你的检测逻辑 return Result.NOT_FOUND } }

2. 实现检测逻辑

在detect方法中，你可以实现各种检测逻辑。这可能包括：

• 检查特定文件或目录的存在
• 查询系统属性
• 分析应用进程信息
• 检测可疑的系统调用

例如，你可以创建一个检测特定恶意应用包名的检测器：

class MaliciousPackageDetector(context: Context) : IDetector(context) { override val name = "恶意应用包名检测" private val maliciousPackages = listOf( "com.example.malware", "com.example.virus" ) override suspend fun detect(): Result { val packageManager = context.packageManager return try { maliciousPackages.any { packageManager.getPackageInfo(it, 0) != null }.let { if (it) Result.FOUND else Result.NOT_FOUND } } catch (e: Exception) { Result.METHOD_UNAVAILABLE } } }

3. 注册新的检测器

创建完新的检测器后，需要将其注册到应用中。在app/src/main/java/icu/nullptr/applistdetector/MainPage.kt文件中，你可以找到检测器的注册逻辑。

val detectors = listOf( PMConventionalAPIs(context, "常规PM API检测"), PMQueryIntentActivities(context, "PM查询意图活动"), // 添加你的自定义检测器 CustomDetector(context, "自定义检测") )

自定义规则实现

Ruru允许开发者实现自定义的检测规则，以满足特定的安全需求。

规则配置文件

你可以创建规则配置文件，定义需要检测的模式。例如，创建一个JSON文件custom_rules.json，存放于assets目录下：

{ "suspiciousPackages": [ "com.example.suspicious", "com.example.dangerous" ], "suspiciousFiles": [ "/system/bin/su", "/data/local/tmp/malware" ] }

规则解析器

然后创建一个规则解析器，读取并解析这些配置：

class RuleParser(context: Context) { private val rules: CustomRules init { rules = loadRulesFromAssets(context) } private fun loadRulesFromAssets(context: Context): CustomRules { val inputStream = context.assets.open("custom_rules.json") val json = inputStream.bufferedReader().readText() return Json.decodeFromString<CustomRules>(json) } fun getSuspiciousPackages(): List<String> = rules.suspiciousPackages fun getSuspiciousFiles(): List<String> = rules.suspiciousFiles }

基于规则的检测器

最后，创建一个基于规则的检测器：

class RuleBasedDetector( context: Context, private val ruleParser: RuleParser ) : IDetector(context) { override val name = "基于规则的检测" override suspend fun detect(): Result { val fileDetector = FileDetection(context, false, "文件系统检测") // 检测可疑文件 val hasSuspiciousFile = ruleParser.getSuspiciousFiles().any { file -> fileDetector.checkFileExists(file) } if (hasSuspiciousFile) return Result.FOUND // 检测可疑应用 val packageManager = context.packageManager val hasSuspiciousPackage = ruleParser.getSuspiciousPackages().any { pkg -> try { packageManager.getPackageInfo(pkg, 0) != null } catch (e: Exception) { false } } return if (hasSuspiciousPackage) Result.FOUND else Result.NOT_FOUND } }

检测结果展示

Ruru提供了直观的检测结果展示界面。检测结果会以卡片形式显示在应用的主界面上。

在app/src/main/java/icu/nullptr/applistdetector/component/CheckCard.kt和CheckCard2.kt文件中，你可以找到卡片组件的实现。这些组件根据IDetector.Result的值，显示不同的图标和状态：

• NOT_FOUND：显示"未发现"状态
• FOUND：显示"发现可疑"状态
• SUSPICIOUS：显示"可疑"状态
• METHOD_UNAVAILABLE：显示"检测方法不可用"状态

你可以根据需要自定义这些卡片的外观和行为，以更好地展示你的自定义检测结果。

总结

通过扩展IDetector接口和实现自定义规则，你可以轻松增强Ruru的检测能力。无论是添加新的检测方法，还是根据特定需求定制检测规则，Ruru的灵活架构都能满足你的需求。

开始使用Ruru，为Android设备提供更强大的安全防护吧！你可以通过以下命令获取项目代码：

git clone https://gitcode.com/gh_mirrors/rur/Ruru

加入Ruru的开发社区，一起打造更安全的Android生态系统！ 🚀

【免费下载链接】RuruAn android sample app of detecting suspicious apps like magisk manager项目地址: https://gitcode.com/gh_mirrors/rur/Ruru