Setup

Requirements

• ADB
• The frps needs to be hosted somewhere on the internet (it's already hosted on AWS)
• Android Docker Emulator
• Must be connected to the Agile's VPN

Note: you won't need to run the frpc separetely because the Android Docker Emulator already calls it.

Getting started

What's the Android Docker Emulator?

It's a local API that allows you to control your devices via the endpoints it exposes. It communicate with the you devices via ADB.

Why do you need to run it?

The frpc isn't able to expose a device directly because it exposes an application at a specific port. So, the Android Docker Emulator is running on a local port and can communicate to all your devices.

If your device is listed when you execute adb devices, the Android Docker Emulator will already have access to it.

How to run?

First, at the computer that will expose the target device:

1. Make sure the target device is listed when you run

   adb devices

2. Open the Android Docker Emulator directory and open the file at /frp/frpc/frpc.toml and configure the file as following:

   serverAddr = "qa-adm-frps.agilecontent.solutions"
   serverPort = 7000
   
   auth.method = "token"
   auth.token = "<frpc-token>" # You can find it at qa-container-passwords.txt
   
   [[proxies]]
   name = "example-name"
   type = "http"
   localIP = "host.docker.internal"
   localPort = 8001 # The local port you want to expose. By default, the Android Docker Emulator is exposed at port 8001
   customDomains = ["qa-adm-frps.agilecontent.solutions"]
   locations = ["/example-name"] # When the frpc is connected to the frps, you'll access the client with "http://qa-adm-frps.agilecontent.solutions:3395/example-name"

3. Run the Android Docker App
4. Check if the the connection with frps was successfull. To do so, you can open the frps dashboard. The credentials to access the dashboard are at qa-container-password.txt

If everything worked, now you can access the Android Docker Emulator anywhere via http://qa-adm-frps.agilecontent.solutions:3395/<configured-path>.

Note: Both the computer that will expose the Android Docker Emulator and the one who will access it must be connected to the Agile's VPN.