1. Create Application
To create your application, prepare a new project with the following steps:
- Download the APK template: from the download page https://jaxa.krpc.jp/download
- Extract the zip file: Extract it to the directory where you want it.
- Launch Android Studio.
- Open the APK template folder: Select [File] → [Open] and choose the template folder.
- Open YourService.java: Navigate to [app/java/jp.jaxa.iss.kibo.rpc.defaultapk/YourService.java] in Project view.
- Write your code: Implement your code in the runPlan1 and runPlan3 methods in the YourService.java file.
- ⚠️Note: When you open the APK template folder, the “Android Gradle Plugin Update Recommended” dialog may appear. However, you must not update the plugin due to a dependency problem. Select “Don’t remind me again for this project”.
To run sample-apk:
- Download Sample APK: from the download page https://jaxa.krpc.jp/download
- Follow the previous steps for Template APK
- Note: make sure the apk in
activity_main.xmlmatches apk inMainActivity.java(i.e.tools:context="jp.jaxa.iss.kibo.rpc.sampleapk.MainActivity")
2. Build APK
▶️3rd Kibo-RPC Tutorial Video: 03 How to Build APK and Simulator
On Windows, build your application with the following steps
- Open <YOUR_APK_PATH> in Android Studio (e.g. Sample APK)
- Create APK file
- Click app on the [Project] window.
- Select [Build] → [Make Module ‘app’] (Don’t update Gradle).
- The built APK file is stored in “<YOUR_APK_PATH>\app\build\outputs\apk\debug\app-debug.
If you find errors, please build an APK file on an Ubuntu machine. apk”.
3. Execution of the Simulator
- Using the simulator server
- Once you have built your application, you can run it on the web simulator provided by JAXA.
- Note that the actual Kibo environment is not exactly the same as the simulation environment, since there are many objects in the Kibo and the environment changes frequently.
Actual environment
- Access the web simulator
- Log in to Kibo-RPC site https://jaxa.krpc.jp/
- Click SIMULATION button
- Select left-hand tab (e.g. Preliminary Trial) and drag and drop
app-debug.apkfile - Confirm settings and click “START SIMULATION”
- The simulation will take 20+ minutes to run
- View simulation
- While simulation is running, click “SIMULATIOR VIEWER” button to show remote connection login info
- Click “VIEW” to connect to NoVNC and use RVIZ to show Astrobee moving in the simulation
- Check results
- Click “VIEW RESULT” to see simulation details (i.e. game time,the matching of areas and items, etc.)
- Found item report
- Green check: Astrobee found the lost item the astronaut was looking for at the correct position within the time limit.
- Red X: Astrobee did not try to execute takeTargetItemSnapshot API or executed at wrong position.
- Recognition report
- Green check: Correct type and number of items reported
- Red X: Wrong type and number of items reported
- Download Log FIles
- Contains a “result.json” file of game score and Android Emulator log
- Download Rosbag File
- Allows you to replay the simulation with adjustable rosbag player and rviz settings
