Back to Repositories

Testing AndResGuard Resource Remapping in Apktool

This test suite validates the AndResGuard functionality in Apktool, focusing on the decoding of APK resources and resource folder remapping. The tests ensure proper handling of AndResGuard-protected applications during the decoding process.

Test Coverage Overview

The test suite provides comprehensive coverage of AndResGuard resource decoding scenarios.

  • Tests resource remapping in normal decode mode
  • Verifies raw mode decoding behavior
  • Validates file path transformations for protected resources
  • Ensures proper handling of mipmap resources

Implementation Analysis

The testing approach utilizes JUnit framework with a structured setup using @BeforeClass for test resource preparation. The implementation leverages ExtFile for file handling and ApkDecoder for processing APK files.

  • Uses inheritance from BaseTest for common functionality
  • Implements separate test cases for normal and raw decode modes
  • Employs TestUtils for resource management

Technical Details

  • JUnit testing framework
  • ApkDecoder for APK processing
  • ExtFile for extended file operations
  • TestUtils for resource management
  • Config class for decode settings
  • BrutException handling

Best Practices Demonstrated

The test suite demonstrates several testing best practices including proper test isolation and resource cleanup.

  • Clear test method naming conventions
  • Proper test setup and resource management
  • Specific assertion checks
  • Separate test cases for different decode modes
  • Effective use of configuration options

ibotpeaches/apktool

brut.apktool/apktool-lib/src/test/java/brut/androlib/decode/AndResGuardTest.java

            
/*
 *  Copyright (C) 2010 Ryszard Wiśniewski <[email protected]>
 *  Copyright (C) 2010 Connor Tumbleson <[email protected]>
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *       https://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */
package brut.androlib.decode;

import brut.androlib.ApkDecoder;
import brut.androlib.BaseTest;
import brut.androlib.Config;
import brut.androlib.TestUtils;
import brut.directory.ExtFile;
import brut.common.BrutException;

import java.io.File;

import org.junit.*;
import static org.junit.Assert.*;

public class AndResGuardTest extends BaseTest {
    private static final String TEST_APK = "issue1170.apk";

    @BeforeClass
    public static void beforeClass() throws Exception {
        TestUtils.copyResourceDir(AndResGuardTest.class, "decode/issue1170", sTmpDir);
    }

    @Test
    public void checkifAndResDecodeRemapsRFolder() throws BrutException {
        ExtFile testApk = new ExtFile(sTmpDir, TEST_APK);
        ExtFile testDir = new ExtFile(testApk + ".out");
        new ApkDecoder(testApk, sConfig).decode(testDir);

        assertTrue(new File(testDir, "res/mipmap-hdpi-v4/a.png").isFile());
    }

    @Test
    public void checkIfAndResDecodeRemapsRFolderInRawMode() throws BrutException {
        sConfig.setForceDelete(true);
        sConfig.setDecodeResources(Config.DECODE_RESOURCES_NONE);

        ExtFile testApk = new ExtFile(sTmpDir, TEST_APK);
        ExtFile testDir = new ExtFile(testApk + ".raw.out");
        new ApkDecoder(testApk, sConfig).decode(testDir);

        assertTrue(new File(testDir, "r/a/a.png").isFile());
    }
}