Development-Information/Firefox-Android/Building.md

@@ -165,9 +165,25 @@ dependencySubstitutions.geckoviewTopsrcdir=/FULL/PATH/TO/tor-browser
 autoPublish.android-components.dir=../android-components
 ```
 
-You will also need the artifacts from `tor-android-service` and `tor-onion-proxy-library`.
-If ever ran an Android build with tor-browser-build, you can use the `fenix/tools/tba-fetch-deps.sh` script.
-It assumes `tor-browser-build.git` has been checked out at the same level of `firefox-android.git`, but you can also specify another directory with the `TOR_BROWSER_BUILD` environment variable.
+#### Fetching required build artifacts
+
+To build the final tor browser for android a few other dependencies are needed: `android-release.aar`, `service-release.aar`, `universal-0.0.3.jar`, and a `noscript.xpi`. We build these in tor-browser-build and we have a script to harvest them and place them in the right places inside the fenix build directories. If you have a local tor-browser-build, in the same parent directory of the firefox-android repo directory, you can call `tools/tba-fetch-deps.sh` from the `fenix` directory.
+
+If you cannot run tor-browser-build locally you will need to set it up somewhere else (like the build servers) and run an android build to generate the required files, or get someone else to. Then you will need to copy them into a local skeleton of tor-browser-build so that the `tools/tba-fetch-deps.sh` can find them. The files you need and structure to recreate is as follows
+
+```
+tor-browser-build/out/
+  tor-android-service/tor-android-service-xxxxxxxxxxxx-xxxxxx/
+    jsocksAndroid-release.aar  
+    service-release.aar
+  tor-onion-proxy-library/tor-onion-proxy-library-xxxxxxxxxxxx-xxxxx
+    android-release.aar  
+    universal-0.0.3.jar
+  browser
+    noscript-xx.x.x.xpi
+```
+
+#### Building
 
 Open `fenix` in android studio and build (`Build > Make Project`).