Obfuscar在Xamarin.Android项目中的使用实践

背景介绍

Obfuscar是一个.NET代码混淆工具，能够有效保护.NET应用程序的知识产权。在Xamarin.Android项目中，代码混淆尤为重要，因为Android应用容易被反编译。本文将详细介绍如何在最新的dotnet/android项目中使用Obfuscar进行代码混淆。

问题分析

在传统的Xamarin.Forms项目中，Obfuscar的配置相对简单。但随着dotnet/android（原Xamarin.Android）的更新，项目结构和构建流程发生了变化，导致原有的Obfuscar配置不再适用。

主要问题表现为：

1. 构建过程中生成的DLL文件路径发生了变化
2. 多架构构建导致需要处理多个不同路径下的DLL文件
3. 混淆时机需要与新的构建流程相匹配

解决方案

1. 选择正确的混淆时机

在dotnet/android项目中，最佳混淆时机是在ILLink（链接器）完成之后，AOT编译之前。这是因为：

• ILLink会移除未使用的代码，减少需要混淆的代码量
• AOT编译需要处理混淆后的代码
• 此时所有架构的DLL文件已经准备就绪

2. 配置MSBuild目标

在项目文件中添加以下Target配置：

<Target Name="ObfuscarReleaseAll" AfterTargets="ILLink" Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
    <Message Text="开始混淆处理..." Importance="High" />
    <Exec WorkingDirectory="$(MonoAndroidIntermediateAssetsDir)..\..\linked\" Command="$(Obfuscar) $(ProjectDir)obfuscar_dll_arch.xml" />
    <Copy SourceFiles="$(MonoAndroidIntermediateAssetsDir)..\..\linked\Obfuscator_Output\myAssembly.dll" DestinationFolder="$(MonoAndroidIntermediateAssetsDir)..\..\linked\" />
    <Message Text="混淆处理完成" Importance="High" />
</Target>

3. Obfuscar配置文件

创建obfuscar_dll_arch.xml配置文件：

<?xml version='1.0'?>
<Obfuscator>
  <Var name="InPath" value="." />
  <Var name="OutPath" value="$(InPath)\Obfuscator_Output" />
  <Var name="KeepPublicApi" value="true" />
  <Var name="HidePrivateApi" value="true" />
  <Var name="SuppressIldasm" value="false" />
  <Var name="AnalyzeXaml" value="false" />
  <Var name="HideStrings" value="false" />
  <Var name="UseUnicodeNames" value="false" />
  <Var name="RenameProperties" value="false" />
  <Var name="RenameFields" value="false" />
  <Var name="RenameEvents" value="false" />
  <Module file="$(InPath)\myAssembly.dll" />
</Obfuscator>

关键配置说明

1. KeepPublicApi：保持公共API不变，确保Xamarin.Android的绑定能够正常工作
2. HidePrivateApi：混淆私有成员，提高代码安全性
3. AnalyzeXaml：设为false以避免XAML相关的问题
4. RenameProperties/Fields/Events：设为false以避免运行时反射问题

注意事项

1. 混淆后的DLL文件需要复制回原位置，以便后续构建步骤使用
2. 建议在Release模式下启用混淆
3. 测试混淆后的应用功能是否正常，特别是依赖反射的功能
4. 对于多架构构建，上述配置会自动处理所有架构的DLL文件

总结

通过上述配置，可以在dotnet/android项目中成功使用Obfuscar进行代码混淆。关键在于选择合适的混淆时机和正确的DLL文件路径。这种方法简化了多架构处理，确保了混淆效果，同时保持了应用的正常功能。