https://github.com/zhanghai/BeeShell

Java REPL on Android with BeanShell
https://github.com/zhanghai/BeeShell

android android-application java repl

Last synced: about 2 months ago
JSON representation

Java REPL on Android with BeanShell

• Host: GitHub
• URL: https://github.com/zhanghai/BeeShell
• Owner: zhanghai
• License: apache-2.0
• Created: 2021-06-13T02:22:45.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2024-07-24T18:17:48.000Z (5 months ago)
• Last Synced: 2024-08-01T03:16:13.175Z (4 months ago)
• Topics: android, android-application, java, repl
• Language: Kotlin
• Homepage:
• Size: 376 KB
• Stars: 109
• Watchers: 6
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: docs/contributing.md
  • License: LICENSE

Awesome Lists containing this project

• stars - zhanghai/BeeShell

README

        
# BeeShell

[![Android CI status](https://github.com/zhanghai/BeeShell/workflows/Android%20CI/badge.svg)](https://github.com/zhanghai/BeeShell/actions) [![GitHub release](https://img.shields.io/github/v/release/zhanghai/BeeShell)](https://github.com/zhanghai/BeeShell/releases) [![License](https://img.shields.io/github/license/zhanghai/BeeShell?color=blue)](LICENSE)

![BeeShell](app/src/main/res/mipmap-xxxhdpi/launcher_icon.png)

Java REPL on Android with [BeanShell](https://github.com/beanshell/beanshell).

Useful for quickly checking some framework API behavior, or calling Java APIs with the permissions of ADB shell.

This is not an officially supported Google product.

[](https://play.google.com/store/apps/details?id=me.zhanghai.android.beeshell)

[Get the APK](https://github.com/zhanghai/BeeShell/releases/latest/download/app-release.apk)

## Preview

 


## Built-ins

The application `Context` is available via the `context` variable in the global namespace.

An `Activity` instance is also available as `activity` when running with UI, and references to it in the global namespace will be cleared upon rotation to avoid memory leaks.

A system `Context` instance is also available as `systemContext` when running in ADB shell.

Other BeanShell built-ins are also available, though not guaranteed to work, e.g. Swing-based UI built-ins won't work on Android.

## Running in ADB shell

Execute the following command in `adb shell`:

```

pm_path=`pm path me.zhanghai.android.beeshell` && apk_path=${pm_path#package:} && `dirname $apk_path`/lib/*/libbsh.so

```

## Limitation

[BeanShell](https://github.com/beanshell/beanshell) was written for running on a desktop JVM instead of Android, and as a result class-related Java syntax may be unsupported in this app. Specifically, you cannot define new classes except for anonymous inner classes implementing an existing interface.

## License

    Copyright 2020 Google LLC

    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.