summaryrefslogtreecommitdiff
path: root/ipscrambling/README.md
diff options
context:
space:
mode:
authorGuillaume Jacquart <guillaume.jacquart@hoodbrains.com>2023-07-11 07:11:15 +0000
committerGuillaume Jacquart <guillaume.jacquart@hoodbrains.com>2023-07-11 07:11:15 +0000
commit921756bb2f3bb7891386f5aac551fe775d454a78 (patch)
tree9d1162115ae1e27ad27417f3ba90a3fb72919e00 /ipscrambling/README.md
parent8b1855bce1313ad84df8f96efdbb62e2acf7ff33 (diff)
2: integrate ipscrambling module in git repos and update dependencies
Diffstat (limited to 'ipscrambling/README.md')
-rw-r--r--ipscrambling/README.md42
1 files changed, 42 insertions, 0 deletions
diff --git a/ipscrambling/README.md b/ipscrambling/README.md
new file mode 100644
index 0000000..777b6a1
--- /dev/null
+++ b/ipscrambling/README.md
@@ -0,0 +1,42 @@
+# Ipscrambling module
+
+This Module implements IpScramblerModule functionnalities with Tor, reliying on a fork of OrbotService.
+
+# Build
+
+Ipscrambling includes a git repo submodules of OrbotService, the module used by Orbot to run Tor
+
+Be sure that you have all of the git submodules up-to-date:
+
+ git submodule update --init --recursive
+
+You can build the AAR modules :
+
+ ./gradlew :ipscrambling:orbotservice:assembleRelease
+
+To deploy localy during development
+
+ ./gradlew --console=verbose publishToMavenLocal
+
+This will put compiled AAR and pom file exposing their dependencies in the local maven
+repository (usually in ~/.m2/repository).
+
+
+To push release on gitlab
+
+ ./gradlew --console=verbose publish
+
+# Update orbotservice to an upper Orbot version
+
+1. Upgrade the code: follow the steps in [orbotservice/README.md](orbotservice/README.md)
+2. Prepare the orbotservice the dependencies : follow the steps in [exportdependencies/update_dependencies.md](exportdependencies/update_dependencies.md), first using the mvn install:install-file command
+3. build and deploy orbotservice locally:
+
+ ./gradlew :ipscrambling:orbotservice:assembleRelease
+ ./gradlew --console=verbose :ipscrambling:orbotservice:publishToMavenLocal
+
+5. Test this new version with advanced privacy, and merge the orbotservice.
+6. deploy the orbotservice dependencies to gitlab registry see [exportdependencies/update_dependencies.md](exportdependencies/update_dependencies.md), using mvn deploy:deploy-file command
+7. deploy orbotservice in gitlab registry
+ ./gradlew --console=verbose :orbotservice:publish
+8. Create MR in AdvancedPrivacy.