playtestcloud / node-remap-apktool-unicode-filenames

Command-line utility for remapping unicode filenames to ascii when produced by apktool.

rauf - remap apktool unicode filenames

Purpose:

• apktool is brilliant
  • it works flawlessly 99.9% of the time
• having said that, there is one situation that it doesn't handle brilliantly
  • sometimes it can produce smali filenames that contain unicode
  • Android aapt only permits ascii
  • when this occurs, the apk cannot be rebuilt
    • v2.4.1 does not produce an apk
    • v2.2.2 produces an apk that doesn't work
      • issue tracker implies this was fixed:
        • iBotPeaches/Apktool#885
        • https://github.com/iBotPeaches/Apktool/pull/1390/files
        • https://connortumbleson.com/2017/01/23/apktool-v2-2-2-released/
      • real world testing (both Windows and Linux) proved that it wasn't
• the purpose of this command-line utility is to:
  • walk the file tree
  • detect .smali filenames that contain unicode
  • rename the file
  • perform search/replace to remap all references from the old name to the new
    • class references in smali files
    • package names in xml files

Installation:

npm install --global @warren-bank/node-remap-apktool-unicode-filenames

Usage:

rauf /path/to/decoded/apk/directory

Example:

apktool d /path/to/app.apk
rauf /path/to/app

apktool b /path/to/app -o /path/to/new_app.apk

Requirements:

• Node version: v10.16.0+ or v11.13.0+
  • events.once

Legal:

• copyright: Warren Bank
• license: GPL-2.0