| Colin Cross | 3f40fa4 | 2015-01-30 17:27:36 -0800 | [diff] [blame] | 1 | // Copyright 2015 Google Inc. All rights reserved. |
| 2 | // |
| 3 | // Licensed under the Apache License, Version 2.0 (the "License"); |
| 4 | // you may not use this file except in compliance with the License. |
| 5 | // You may obtain a copy of the License at |
| 6 | // |
| 7 | // http://www.apache.org/licenses/LICENSE-2.0 |
| 8 | // |
| 9 | // Unless required by applicable law or agreed to in writing, software |
| 10 | // distributed under the License is distributed on an "AS IS" BASIS, |
| 11 | // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 12 | // See the License for the specific language governing permissions and |
| 13 | // limitations under the License. |
| 14 | |
| 15 | // Soong is a builder for Android that uses Blueprint to parse Blueprints |
| 16 | // files and Ninja to do the dependency tracking and subprocess management. |
| 17 | // Soong itself is responsible for converting the modules read by Blueprint |
| 18 | // into build rules, which will be written to a build.ninja file by Blueprint. |
| 19 | // |
| 20 | // Android build concepts: |
| 21 | // |
| 22 | // Device |
| 23 | // A device is a piece of hardware that will be running Android. It may specify |
| 24 | // global settings like architecture, filesystem configuration, initialization |
| 25 | // scripts, and device drivers. A device may support all variants of a single |
| 26 | // piece of hardware, or multiple devices may be used for different variants. |
| 27 | // A build is never targeted directly at a device, it is always targeted at a |
| 28 | // "product". |
| 29 | // |
| 30 | // Product |
| 31 | // A product is a configuration of a device, often for a specific market or |
| 32 | // use case. It is sometimes referred to as a "SKU". A product defines |
| 33 | // global settings like supported languages, supported use cases, preinstalled |
| 34 | // modules, and user-visible behavior choices. A product selects one and only |
| 35 | // one device. |
| 36 | // |
| 37 | // Module |
| 38 | // A module is a definition of something to be built. It may be a C library or |
| 39 | // binary, a java library, an Android app, etc. A module may be built for multiple |
| 40 | // targets, even in a single build, for example host and device, or 32-bit device |
| 41 | // and 64-bit device. |
| 42 | // |
| 43 | // Installed module |
| 44 | // An installed module is one that has been requested by the selected product, |
| 45 | // or a dependency of an installed module. |
| 46 | // |
| 47 | // Target architecture |
| 48 | // The target architecture is the preferred architecture supported by the selected |
| 49 | // device. It is most commonly 32-bit arm, but may also be 64-bit arm, 32-bit or |
| 50 | // 64-bit x86, or mips. |
| 51 | // |
| 52 | // Secondary architecture |
| 53 | // The secondary architecture specifies the architecture to compile a second copy |
| 54 | // of some modules for devices that support multiple architectures, for example |
| 55 | // 64-bit devices that also support 32-bit binaries. |
| 56 | package soong |