Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
126 changes: 117 additions & 9 deletions docs/EN/SettingUpAaps/BrowserBuild.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,14 +63,17 @@ GitHub now displays your personal copy of AndroidAPS. Leave this web browser tab
## 2. Preparation Steps

- If you are building from an Android device, install [File Manager Plus](https://play.google.com/store/apps/details?id=com.alphainventor.filemanager) from the Google Play store.
- Download the preparation file from here:
<!--crowdin:disable-->
```{eval-rst}
.. raw:: html

<pre style="font-family: inherit; margin: 0;">
• Download the preparation file from <a href="../_static/CI/aaps-ci-preparation.html" download>here</a>
</pre>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="../_static/CI/aaps-ci-preparation.html" download>aaps-ci-preparation.html</a>
```
<br>
<br>
<br>
<!--crowdin:enable-->

AndroidAPS build requires private keys, that are stored in a Java KeyStore (JKS):

Expand All @@ -88,8 +91,10 @@ The AAPS app will be saved in your Google Cloud drive once built:
(aaps-ci-option1)=
### AAPS-CI Option 1 – Generate JKS
- Suitable for first-time users, or those without a JKS, or who have forgotten the password or alias.
- Here are examples using multiple platforms below.

Compatible with Android
(aaps-ci-option1-android)=
- Compatible with Android(The simplest, recommended as the first choice)
```{eval-rst}
.. raw:: html

Expand All @@ -106,7 +111,8 @@ The AAPS app will be saved in your Google Cloud drive once built:
</div>
```

Compatible with iOS (using iPad as an example)
(aaps-ci-ios-ipad)=
- Compatible with iOS (using iPad as an example)
```{eval-rst}
.. raw:: html

Expand All @@ -123,13 +129,66 @@ The AAPS app will be saved in your Google Cloud drive once built:
</div>
```

(aaps-ci-option1-computer)=
- Use a computer (supports Windows/Mac/Linux)

Open the webpage
https://simplewebserver.org/download.html

Install Simple HTTP Server
If you are a Windows/Mac user, you can install it from the store.
After clicking the link, you will be asked whether to allow opening it. Please choose Open Link.
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server_store.png)

Example on Mac:

- get → install → open
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server.png)

- Click Get Started
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png)

- Click Get Server
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png)

- In Folder Path, select the folder where aaps-ci-preparation.html is located, and then click Create Server.
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png)

- Seeing this screen means the server has been started.
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png)

- Do not close Simple HTTP Server. Please switch to your browser and open
[http://127.0.0.1:8080/aaps-ci-preparation.html](http://127.0.0.1:8080/aaps-ci-preparation.html)

- For the subsequent steps, please refer to the video below, starting from 1 minute 37 seconds.

```{eval-rst}
.. raw:: html

<!--crowdin: exclude-->
<div align="center" style="max-width: 360px; margin: auto; margin-bottom: 2em;">
<div style="position: relative; width: 100%; aspect-ratio: 9/16;">
<iframe
src="https://www.youtube.com/embed/t1VlnCpm-A4?start=97"
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
frameborder="0"
allowfullscreen>
</iframe>
</div>
</div>
```

- As described in the video, please copy it to the corresponding field.

![aaps_ci_pr_ci](../images/Building-the-App/CI/aaps_ci_option1.png)

(aaps-ci-option2)=
### AAPS-CI Option 2 – Upload Existing JKS
- Suitable for users who already have a JKS and know the JKS password and alias.
- Here are examples using multiple platforms below.

(aaps-ci-option2-android)=
- Compatible with Android(The simplest, recommended as the first choice)
```{eval-rst}
.. raw:: html

Expand All @@ -146,6 +205,55 @@ The AAPS app will be saved in your Google Cloud drive once built:
</div>
```

(aaps-ci-option2-computer)=
- Use a computer (supports Windows/Mac/Linux)

Open the webpage
https://simplewebserver.org/download.html

Install Simple HTTP Server
If you are a Windows/Mac user, you can install it from the store.
After clicking the link, you will be asked whether to allow opening it. Please choose Open Link.
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server_store.png)

Example on Mac:

- get → install → open
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server.png)

- Click Get Started
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server_step1.png)

- Click Get Server
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server_step2.png)

- In Folder Path, select the folder where aaps-ci-preparation.html is located, and then click Create Server.
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server_step3.png)

- Seeing this screen means the server has been started.
![simple_http_server](../images/Building-the-App/CI/aaps_ci_simple_http_server_step4.png)

- Do not close Simple HTTP Server. Please switch to your browser and open
[http://127.0.0.1:8080/aaps-ci-preparation.html](http://127.0.0.1:8080/aaps-ci-preparation.html)

- For the subsequent steps, please refer to the video below, starting from 2 minute 18 seconds.

```{eval-rst}
.. raw:: html

<!--crowdin: exclude-->
<div align="center" style="max-width: 360px; margin: auto; margin-bottom: 2em;">
<div style="position: relative; width: 100%; aspect-ratio: 9/16;">
<iframe
src="https://www.youtube.com/embed/L5L3XtnszMQ?start=138"
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
frameborder="0"
allowfullscreen>
</iframe>
</div>
</div>
```

- As described in the video, please copy it to the corresponding field.

![aaps_ci_option2](../images/Building-the-App/CI/aaps_ci_option2.png)
Expand All @@ -164,6 +272,10 @@ The AAPS app will be saved in your Google Cloud drive once built:

![aaps_ci_gdrive_auth](../images/Building-the-App/CI/aaps_ci_gdrive_auth.png)

```{warning}
Customizations are usually not necessary. This is for your information ony.
```

(github-build-apk)=
## AAPS-CI GitHub Actions to Build the AAPS APK
- Suitable for general users.
Expand Down Expand Up @@ -216,10 +328,6 @@ The AAPS app will be saved in your Google Cloud drive once built:

--------

```{warning}
Customizations are usually not necessary. This is for your information ony.
```

(github-cherry-pick)=

## If you want to add a specific commit to your branch, please use cherry-pick.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.