This article aims to deeply explore the technical details of the Huawei HarmonyOS Next system (up to API 12 as of now), and is summarized based on actual development practices.
It mainly serves as a vehicle for technical sharing and communication. Mistakes and omissions are inevitable. Colleagues are welcome to put forward valuable opinions and questions so that we can make progress together.
This article is original content, and any form of reprint must indicate the source and the original author.

Introduction

In the field of mobile application development, code security has always been a key concern for developers. Code obfuscation, as an effective security measure, can protect the application source code from being easily reverse-engineered. ArkTS, as the development language of HarmonyOS Next, provides powerful code obfuscation capabilities. This article will detail how to implement code obfuscation in ArkTS and how to balance security and performance.

Code Obfuscation Overview

Code obfuscation is a technique that alters the form of program code to make it difficult to understand. The main purposes and types of code obfuscation are as follows:

• Purposes:

  • Prevent reverse engineering.
  • Protect intellectual property.
  • Reduce code readability and increase the difficulty of cracking.

• Types:

  • Name Obfuscation: Includes obfuscation of class names, method names, and field names.
  • Layout Obfuscation: Changes the layout and structure of the code.
  • Data Obfuscation: Includes encryption of constant strings, numerical obfuscation, etc.
  • Control Flow Obfuscation: Alters the execution flow of the code.

How to Enable Code Obfuscation

In the HarmonyOS development environment, enabling code obfuscation usually involves the following steps:

1. Configure build-profile.json5: In the project's build-profile.json5 file, set obfuscation to true under the release configuration.

{
  "release": {
    "obfuscation": true,
    "obfuscationSettings": {
      // Obfuscation configuration
    }
  }
}

1. Set Obfuscation Rules: In obfuscationSettings, you can define rules to exclude specific packages or classes, as well as specific obfuscation strategies.

"obfuscationSettings": {
  "exclude": ["com.example.excluded"],
  "optimization": true,
  "rename": {
    "rules": [
      {
        "search": "^(.*)MyClass$",
        "replace": "Confused$1"
      }
    ]
  }
}

Obfuscation Strategies

The following is a detailed explanation of some advanced obfuscation strategies:

• Name Obfuscation:

  • Use regular expressions to define complex renaming rules.
  • Generate random or meaningless names for classes, methods, and fields.

• Layout Obfuscation:

  • Move method bodies and change the calling order of methods.
  • Insert irrelevant code to increase the complexity of the code.

• Data Obfuscation:

  • Encrypt strings and use a decryption function to restore them at runtime.
  • Transform numerical values so that the original values are not easily recognizable.

• Control Flow Obfuscation:

  • Insert false control flow statements, such as unconditional jumps.
  • Use indirect calls instead of direct calls.

Security and Performance Optimization

When implementing code obfuscation, the following considerations are necessary to balance security and performance:

• Test the Obfuscated Application: Ensure that the obfuscated application still functions properly and does not introduce new errors.
• Performance Evaluation: Obfuscation may increase the execution time and size of the code, so performance evaluation is required.
• Obfuscation Level: Select an appropriate obfuscation level based on the application's security requirements and performance requirements.

Debugging Obfuscated Code

Debugging obfuscated code can be difficult. Here are some tips:

• Retain Log Information: Exclude logging-related classes and methods in the obfuscation configuration so that useful information can be read during debugging.
• Use Source Maps: Some obfuscation tools support generating source map files, which can map back to the original source code during debugging.

An Example

The following is a more complex example of obfuscation rule configuration:

"obfuscationSettings": {
  "exclude": ["com.example.logging.Logger"],
  "optimization": true,
  "rename": {
    "rules": [
      {
        "search": "^(.*)MyClass$",
        "replace": "Confused$1"
      },
      {
        "search": "^(.*)myMethod$",
        "replace": "m$1"
      }
    ]
  },
  "controlFlow": {
    "enable": true,
    "complexity": 3
  },
  "data": {
    "stringEncryption": {
      "enable": true,
      "exclude": ["com.example.resources.Strings"]
    }
  }
}

In the above configuration, we have not only set name obfuscation rules but also enabled control flow obfuscation and data obfuscation, and configured string encryption.

Summary

Code obfuscation is an important means to enhance the security of ArkTS applications. By thoroughly understanding different obfuscation strategies and how to configure obfuscation rules in DevEco Studio, we can effectively protect our code from reverse engineering while maintaining the application's performance. In practical applications, we can select an appropriate obfuscation level and strategy based on the specific requirements and risk assessment of the application.