Registered User mNo edit summary Tag: 2017 source edit |
Registered User mNo edit summary |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 3: | Line 3: | ||
|MPUs checklist=STM32MP13x, STM32MP15x, STM32MP25x | |MPUs checklist=STM32MP13x, STM32MP15x, STM32MP25x | ||
}}</noinclude> | }}</noinclude> | ||
{{FlowCompatibility/Android}} | |||
This article explains how to build the OpenSTDroid distribution. It is intended for Distribution Package users. | This article explains how to build the OpenSTDroid distribution. It is intended for Distribution Package users. | ||
| Line 11: | Line 10: | ||
The environment must be installed using the Distribution Package adapted to your microprocessor device. | The environment must be installed using the Distribution Package adapted to your microprocessor device. | ||
In addition follow the [[PC prerequisites]] dedicated to Android to make sure all the packages required to use the environment are | In addition, follow the [[PC prerequisites]] dedicated to Android to make sure all the packages required to use the environment are available. | ||
== Build == | == Build == | ||
| Line 17: | Line 16: | ||
First execute the following command: | First execute the following command: | ||
{{PC$}} source ./build/envsetup.sh | {{PC$}}source ./build/envsetup.sh | ||
It sets several required environment variables for the build and adds several useful scripts in your path. | It sets several required environment variables for the build and adds several useful scripts in your path. | ||
| Line 24: | Line 23: | ||
Use the command below to list some interested aliases created by <code>envsetup.sh</code>: | Use the command below to list some interested aliases created by <code>envsetup.sh</code>: | ||
{{PC$}} hmm | {{PC$}}hmm | ||
If | If it is the first time you set up an environment to build Android, continue to read this article. Otherwise, go directly to [[#Choosing a build target | Choosing a build target]]. | ||
=== Choosing a build target === | === Choosing a build target === | ||
| Line 33: | Line 32: | ||
To choose your target device, execute the command below: | To choose your target device, execute the command below: | ||
{{PC$}} lunch aosp_{{HighlightParam|''<BoardId>''}}-{{HighlightParam|''<build_type>''}} | {{PC$}}lunch aosp_{{HighlightParam|''<BoardId>''}}-{{HighlightParam|''<build_type>''}} | ||
The available <code>build_type</code> values are the following: | The available <code>build_type</code> values are the following: | ||
| Line 42: | Line 41: | ||
=== Platform setup === | === Platform setup === | ||
Execute this {{HighlightParam|<STM32Series>}} setup '''only once''', | Execute this {{HighlightParam|<STM32Series>}} setup '''only once.''' For example, for STM32MP2 series: | ||
{{PC$}} stm32mp2setup | {{PC$}}stm32mp2setup | ||
It applies specific patches related to your {{HighlightParam|<STM32Series>}} to customize Android and load the necessary libraries and modules. | It applies specific patches related to your {{HighlightParam|<STM32Series>}} to customize Android and load the necessary libraries and modules. | ||
| Line 63: | Line 62: | ||
You are now ready to build. To do this, just launch the command: | You are now ready to build. To do this, just launch the command: | ||
{{PC$}} make -j | {{PC$}}make -j | ||
Depending on your computer settings, several hours might be required to execute this command on the first build. | Depending on your computer settings, several hours might be required to execute this command on the first build. | ||
| Line 72: | Line 71: | ||
<noinclude> | <noinclude> | ||
{{PublicationRequestId | | {{PublicationRequestId | 33631 | 2025-01-13 | }} | ||
[[Category:How to Android]] | [[Category:How to Android]] | ||
[[Category:Android]] | [[Category:Android]] | ||
</noinclude> | </noinclude> | ||
Latest revision as of 12:59, 17 March 2025
This article explains how to build the OpenSTDroid distribution. It is intended for Distribution Package users.
1. Prerequisites[edit | edit source]
The environment must be installed using the Distribution Package adapted to your microprocessor device.
In addition, follow the PC prerequisites dedicated to Android to make sure all the packages required to use the environment are available.
2. Build[edit | edit source]
First execute the following command:
source ./build/envsetup.sh
It sets several required environment variables for the build and adds several useful scripts in your path. It is mandatory to start with this command as soon as you are using a new terminal.
Use the command below to list some interested aliases created by envsetup.sh:
hmm
If it is the first time you set up an environment to build Android, continue to read this article. Otherwise, go directly to Choosing a build target.
2.1. Choosing a build target[edit | edit source]
To choose your target device, execute the command below:
lunch aosp_<BoardId>-<build_type>
The available build_type values are the following:
user: to generate an end-user production image;userdebug: similar to anuserbuild but with root access and debug capabilities;eng: development configuration with additional debugging tools.
2.2. Platform setup[edit | edit source]
Execute this <STM32Series> setup only once. For example, for STM32MP2 series:
stm32mp2setup
It applies specific patches related to your <STM32Series> to customize Android and load the necessary libraries and modules.
2.3. Customizing the distribution[edit | edit source]
To customize the distribution, refer to How to customize OpenSTDroid distribution page.
2.4. Generating the image[edit | edit source]
You are now ready to build. To do this, just launch the command:
make -j
Depending on your computer settings, several hours might be required to execute this command on the first build.
The result can be found in the out folder. The generated partition images are located in out/target/product/<BoardId>.
To flash images, refer to How to populate boards for Android page.