2. First Steps with Amandroid

Amandroid uses development platform provided by Sireum. So the first thing we need to do is to setup Sireum command-line interface (CLI).

2.1. Setup Sireum CLI

Sireum CLI setup is pretty strait-forward, following steps need to be followed:

  1. Follow instructions in Sireum Shortcake to download and setup Sireum-ide, make sure you are using the dev(nightly) version.

  2. Launch Eclipse:

    $ sireum launch sireumdev -j "-Xms256m,-Xmx2048m"
    

    This will launch Eclipse IDE with all required pulgins. -j "-Xms512m,-Xmx4096m" is parameter gives to Eclipse (you can modify it based on your machines performance).

After above steps you will get a working development platform with all the necessary plugins setup. Then it is time to get code of Amandroid.

2.2. Checking Out the Source of Amandroid

Amandroid is implemented on top of Sireum, so following Sireum repositories are needed to be able to run Amandroid:

Sireum Prelude: https://github.com/sireum/prelude

Sireum Parser: https://github.com/sireum/parser

Sireum Core: https://github.com/sireum/core

Sireum Jawa: https://github.com/sireum/jawa

Amandroid’s repository:

Sireum Amandroid: https://github.com/sireum/amandroid

Clone all the required repositories into your workspace using Eclipse:

  1. Switch to the Git Repository Exploring perspective in Eclipse.

  2. Click Clone a Git Repository and give the URL. Then, fill in necessary informations until finish.

  3. Wait for the repository to be cloned—this may take a couple of minutes.

  4. Import all the projects in order (from Sireum Prelude to Sireum Amandroid) by:

    right-click on each repository -> select Import Projects -> check Import existing projects and go Next -> Click Finish with all projects checked.

  5. Wait for the projects to be imported, and the indexing to finish.

2.3. TroubleShooting

  1. The order of importing those repositories is really important.
  2. Sometimes, after you import all the projects it will show error mark on some of the projects. Just clean all projects.