v1.5.0: Fix certificate authorities on Android

This releases fixes a problem which occurred on Android, where installed certificate authorities were not recognized due to wrong file permissions.

What's Changed

• Fixes #138: Set correct file and SE Linux permissions on CA certificates by @zner0L in #139

Full Changelog: v1.4.0...v1.5.0

v1.4.0: Function to save Android emulator snapshots

This release adds a minor feature for Android emulators: You can now save the emulator state as a snapshot using the snapshotDeviceState(snapshotName) function.

What's Changed

• Add method to save emulator snapshots by @zner0L in #137

Full Changelog: v1.3.1...v1.4.0

v1.3.1: Export version in package

This patch exports the version as a constant appstractionVersion in the module, to address problems raised in (among others) tweaselORG/cyanoacrylate#50.

What's Changed

• Towards tweaselORG/cyanoacrylate#50: Print version into file to export by @zner0L in #136

Full Changelog: v1.3.0...v1.3.1

v1.3.0: Honey data automation

This release brings new functions on both Android and iOS that allow you to programmatically place honey data on devices and emulators. In addition to setting the clipboard (which was already supported), you can now change the device name and create contacts and calendar events.

What's Changed

• Towards #123: Add system APIs to place honey data on the device by @zner0L in #134

Full Changelog: v1.2.0...v1.3.0

v1.2.0: More metadata on apps and devices

In this release, we improve on our current function to get metadata of apps on the host device, parseAppMeta(). It now exports its return type, so that it is easier to use in other TypeScript projects. Also, we added some metadata, such as the platform the app is intend to run on and a md5 hash of the package. Although we want to caution you to place too much value in this hash, because apps files may differ from download to download (see our discussion in tweaselORG/cyanoacrylate#39).

Also, you can now get more metadata about the device the analysis is running on, by using device.getDeviceAttribute(). This way you can provide more detailed information on your test environment.

What's Changed

• Fixes #129: Support for getting additional device attributes by @baltpeter in #130
• parseAppMeta(): Expose return type, include platform and MD5 by @baltpeter in #131

Full Changelog: v1.0.1...v1.2.0

v1.0.1: Fix WireGuard APK download

This is just a small bugfix release that mainly solves the problem of the automated setup of WireGuard on Android devices not working anymore.

Additionally, we now make it explicit that we currently need Node 18 exactly. This has always been the case, but we now fail when trying to install on a newer Node version.

What's Changed

• Download WireGuard APK from their website (instead of F-Droid) by @zner0L in #125
• Require exactly Node 18 by @baltpeter in #133

Full Changelog: v1.0.0...v1.0.1

v1.0.0: New unpinning script, easier connections on iOS, and lots of improvements and bugfixes

This release brings a lot of improvements and bugfixes. A few of the changes are breaking (marked in bold below).

Notable changes and new features apart from the bugfixes include:

• We have switched from objection to httptoolkit/frida-android-unpinning as our certificate pinning bypass on Android. Learn more about the investigation that motivated this change: tweaselORG/meta#16
• Connecting to iOS devices via SSH now doesn't require you to specify the device's IP address anymore.
• We now require at least Node 18. Running appstraction on a Node version that is too old would already fail previously, we have just made this explicit.
• A different method for executing commands as root on Android. This should make appstraction work on devices with vanilla AOSP that don't support rooted debugging.
• We now warn you if you have multiple devices (or a device with the wrong platform) connected. There is also a listDevices() function that you can use to get this information programmatically.
• A new listApp() function for getting a list of the app IDs of installed apps on a device.

What's Changed

• Towards tweaselORG/cli#27: listApps() function by @baltpeter in #93
• Fixes #96: Wait for device in resetEmulator() by @baltpeter in #98
• Fixes #97: Fix WireGuard config argument in Android emulator example by @baltpeter in #98
• Fixes #99: Repair regex for getForegroundAppId() on Android by @baltpeter in #100
• Fixes #92: Use su -c instead of the root shell by @zner0L in #94
• Ignore temporary test files by @zner0L in #106
• Fixes #58: Check if a F-Droid suggestedVersionCode exists by @zner0L in #105
• Fixes #95: Create listDevices function and fail with multiple devices by @zner0L in #104
• Fixes #110, #24, #101: Use httptoolkit/frida-android-unpinning by @baltpeter in #111 (breaking)
• Fixes #43, tweaselORG/cli#24: Use iproxy for ssh by @zner0L in #112 (breaking)
• Fixes #102: Kill stuck frida processes by @zner0L in #114
• Fixes #113: Document node v18 as a requirement by @zner0L in #115 (breaking)
• Upgrade to andromatic 1.1.1 by @baltpeter in #116

Full Changelog: v0.4.3...v1.0.0

v0.4.3: Do not assume the adb server is already running

This bugfix introduces a new internal method for the android platform: android._internal.ensureAdb(), which ensures the abd server has been started. Now waitForDevice() and ensureDevice() also work on a freshly booted machine.

What's Changed

• README: Use tweasel-cli for creating emulators by @baltpeter in #86
• Ensure the adb server is running by @zner0L in #91

Full Changelog: v0.4.2...v0.4.3

v0.4.2: Bugfix for race condition

This release aims to deal with a race condition when automatically installing the Python dependencies.

What's Changed

• Update autopy to deal with race condition by @baltpeter in #90

Full Changelog: v0.4.1...v0.4.2

v0.4.1: Bug fix for `waitForDevice()` on iOS

This release fixes a bug in waitForDevice() on iOS: We didn't wait long enough.

What's Changed

• Fix timeout in waitForDevice() on iOS by @baltpeter in #89

Full Changelog: v0.4.0...v0.4.1