apkinjector - GitLite

KO | EN

gitlite — search

#privacy #deep-learning #svg #java #ui #developer-tools #python #react-native #csharp #javascript

apkinjector

(★ 26)

Utilities to help injecting libraries and frida in apks.

파일 탐색기

ZIP 다운로드

- - doc.yaml
  - publish.yaml
- pull_request_template.md
- __init__.py
- __main__.py
- adb.py
- apktool.py
- arch.py
- bundle.py
- dependencies.py
- download.py
- frida.py
- gadget.py
- injector.py
- java.py
- logger.py
- manifest.py
- plugins.py
- uber_apk_signer.py
- utils.py
- - adb.rst
  - apkinjector.rst
  - apktool.rst
  - bundle.rst
  - dependencies.rst
  - download.rst
  - frida.rst
  - gadget.rst
  - java.rst
  - logger.rst
  - manifest.rst
  - plugins.rst
  - uber_apk_signer.rst
- - as_module.rst
  - as_plugin.rst
  - features.rst
  - installation.rst
  - usage.rst
- api.rst
- conf.py
- index.rst
- requirements.txt
- usage.rst
- plugin_example.py
- plugins.json
.gitignore
LICENSE
Makefile
README.md
requirements.txt
setup.py

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`frida`

설명 보기 ▼

개발자, 리버스 엔지니어, 보안 연구자를 위한 동적 계측 툴킷.
더 많은 정보: <https://frida.re/docs/frida-cli/>.

frida {{process_name}}

실행 중인 프로세스에 연결된 대화형 쉘(REPL) 시작:

frida {{[-U|--usb]}} {{process_name}}

USB를 통해 프로세스에 연결된 대화형 쉘 시작:

frida {{[-p|--attach-pid]}} {{pid}}

PID를 사용하여 실행 중인 프로세스에 연결:

🔍

`pip3`

설명 보기 ▼

이 명령은 `pip`의 별칭입니다.

tldr pip

자세한 내용은 원본 명령을 참고하세요:

🔍

`apk`

설명 보기 ▼

Alpine Linux 패키지 관리 도구.
더 많은 정보: <https://wiki.alpinelinux.org/wiki/Alpine_Package_Keeper>.

apk upgrade {{[-U|--update-cache]}}

모든 원격 저장소에서 저장소 색인 업데이트:

apk update

새 패키지 설치:

apk add {{package}}

패키지 제거:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Pluginable tool to automate injection of libraries in apks, with support for unpack, repack, and bundles.

- [APK Injector](#apk-injector)
    - [Features](#features)
    - [Installation](#installation)
    - [Usage](#usage)
      - [Frida](#frida)
      - [Inject](#inject)
      - [Apk utils](#apk-utils)
      - [Plugins](#plugins)
    - [Using as a module](#using-as-a-module)
    - [Usage as a plugin](#usage-as-a-plugin)

### Features
- Insert libraries and load them when an activity starts.
- Frida support with support to load frida scripts either from disc or codeshare.
- Bundle support. Apks exported from SAI or XApks downloaded from apkpure.
- Plugins support. Check plugins/plugins.json and plugin_example.py

### Installation
`pip3 install apkinjector`

### Usage
```
apkinjector [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  apk      Apk utils
  frida    Inject a frida gadget in a target apk.
  inject   Inject a shared library (*.so) in a target apk.
  plugins  Manage plugins
```

#### Frida
```
Usage: python -m apkinjector frida [OPTIONS] APK

Inject a frida gadget in a target apk.

Options:
  --gadget TEXT     Path to custom gadget.
  --script TEXT     Inject a javascript to be loaded when the gadget starts.
  --codeshare TEXT  Same as --script but uses Frida Codeshare as the source
                    javascript.
  --arch TEXT       Architecture to inject for. If empty --adb or --gadget
                    must be specified.
  --adb             Use adb (if installed) to detect device architecture.
  --activity TEXT   Name of the activity to inject into. If unspecified, the
                    main activity will be injected.
  --output          Custom path where the patched apk should be saved.
  --force           Force delete destination directory.
  --help            Show this message and exit.
```

#### Inject
```
Usage: python -m apkinjector inject [OPTIONS] APK

Inject a shared library (*.so) in a target apk.

Options:
  --library TEXT   Shared library (*.so) to inject.  [required]
  --include TEXT   Extra files to include in the lib folder. Can be used
                   multiple times to include more files.
  --arch TEXT      Architecture to inject for. If empty --adb or --library
                   must be specified.
  --adb            Use adb (if installed) to detect device architecture.
  --activity TEXT  Name of the activity to inject into. If unspecified, the
                   main activity will be injected.
  --output         Custom path where the patched apk should be saved.
  --force          Force delete destination directory.
  --help           Show this message and exit.
```

#### Apk utils
```
Usage: python -m apkinjector apk [OPTIONS] APK

Apk utils

Options:
  --activities   Gets all activities
  --permissions  Gets all permissions
  --libraries    Gets all libraries
  --recievers    Gets all receivers
  --help         Show this message and exit.
```

#### Plugins
```
Usage: python -m apkinjector plugins [OPTIONS]

Manage plugins

Options:
  --list          List all installed and available plugins.
  --install TEXT  Installs a plugin by name.
  --remove TEXT   Removes an installed plugin.
  --help          Show this message and exit.
```

### Using as a module

```python
from apkinjector import LOG

LOG.info("This has been printed using apkinjector logging")

# Also comes with runners for apktool, uber-apk-signer, etc/

from apkinjector.apktool import ApkTool

from apkinjector.uber_apk_signer import UberApkSigner

# Automatically download and setup apktool.
ApkTool.install()

# Decompile apk
ApkTool.decode(...)

# Automatically download and setup uber-apk-signer
UberApkSigner.install()

# Sign apk
UberApkSigner.sign(...)

# Check if a dependency is in path

from apkinjector import DEPENDENCIES_MANAGER

# Add a new dependency
java = DEPENDENCIES_MANAGER.add_dependency('java', required=True) # Return Depedency(name, path, required)

# Check if a dependency is path
# Returns the path to the binary if found, if not returns None
# See apkpatcher/apkpatcher to see how dependencies are automatically handled
in_path = DEPENDENCIES_MANAGER.java
```

### Usage as a plugin

```python

# Can use the same methods as a it would been included in a separate module.

from apkinjector import LOG

# Adding a new command to the `apkinjector` application:

from apkinjector.plugins import main

# Define a new command. It uses click under the hood. See more at https://click.palletsprojects.com/en/8.1.x/
# Check plugins/plugin_example.py for a full example.
@main.command(help='Prints hello world to the console.')
def hello_world():
    LOG.info('Hello World')  # prints info
    LOG.warning("Hello World")  # prints warning
    LOG.error('Hello World')  # prints error and calls sys.exit(1)

# This will be usable with `apkinjector hello_world`
# 
# apkinjector hello-world --help
# Usage: python -m apkinjector hello-world [OPTIONS]

#   Prints hello world to the console.

# Options:
#   --help  Show this message and exit. 
```