Skip to content

A shell for android. Can execute most linux shell command in it. You can easy to get last command result. At most time, it like a lite terminal, you can keep global shell in your application.

License

Notifications You must be signed in to change notification settings

holmeszyx/ShellAndroid

Repository files navigation

ShellAndroid

A shell for android. Can execute most linux shell command in it. You can easy to get last command result. At most time, it like a lite terminal, you can keep global shell in your application.

sh --> su --> id the last result: uid=0(root) gid=0(root) 

and then

exit --> id the last result: uid=10103(u0_a103) gid=10103(u0_a103) groups=1028(sdcard_r) 

A exact result of last command got from the ShellAndroid.

How to use

  • If not use ShellAndroid.initFlagMinimum(context), Put the cflag executable file to assets in your project.

  • Initialize the ShellAndroid.(see mainActivity.java in example)

     //---- shell initialization ---- mShell = new ShellAndroid(); // String flagFile = mShell.initFlag(getApplicationContext()); // not suggest to use this for most device String flagFile = mShell.initFlagMinimum(getApplicationContext()); mShell.printOutput(); mShell.setFlagFile(flagFile); //---- finish shell initialization ---- 
  • Close the ShellAndroid if you never need it.(like the example close the shell on the onDestroy method in activity)

     protected void onDestroy(){// TODO Auto-generated method stub super.onDestroy(); if (mShell != null){mShell.close()} } 
  • Execute shell command in a work thread.

  • Get command result by getLastResult() in ShellAndroid.(more details are in example)

     mShell.exec(false, "cd /sdcard"); mShell.exec(false, "pwd"); mShell.getLastResult(); // pwd result, return "/sdcard" 
  • If you want get root permission, the best way is use the shell methods.

     shell.checkRoot() // try to get root permission shell.hasRoot() // Is it the root user now shell.exitRoot() // exit root user, even if you execute su command many times. 

Gradle

easy to use by gradle

compile 'z.hol.shellandroid:library:1.0.3'

Bug

  • Some commands makes the shell unable to work. The known commands below(They almost are interactive commands):

     if wc 

About

A shell for android. Can execute most linux shell command in it. You can easy to get last command result. At most time, it like a lite terminal, you can keep global shell in your application.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages