github.com/westcoastroms/westcoastroms-build@v0.0.0-20190928114312-2350e5a73030/build/make/core/tasks/build_custom_images.mk (about)

     1  #
     2  # Copyright (C) 2015 The Android Open Source Project
     3  #
     4  # Licensed under the Apache License, Version 2.0 (the "License");
     5  # you may not use this file except in compliance with the License.
     6  # You may obtain a copy of the License at
     7  #
     8  #      http://www.apache.org/licenses/LICENSE-2.0
     9  #
    10  # Unless required by applicable law or agreed to in writing, software
    11  # distributed under the License is distributed on an "AS IS" BASIS,
    12  # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13  # See the License for the specific language governing permissions and
    14  # limitations under the License.
    15  #
    16  
    17  # Build additional images requested by the product makefile.
    18  # This script gives the ability to build multiple additional images and you can
    19  # configure what modules/files to include in each image.
    20  # 1. Define PRODUCT_CUSTOM_IMAGE_MAKEFILES in your product makefile.
    21  #    PRODUCT_CUSTOM_IMAGE_MAKEFILES is a list of makefiles.
    22  #    Each makefile configures an image.
    23  #    For image configuration makefile foo/bar/xyz.mk, the built image file name
    24  #    will be xyz.img. So make sure they won't conflict.
    25  # 2. In each image's configuration makefile, you can define variables:
    26  #   - CUSTOM_IMAGE_MOUNT_POINT, the mount point, such as "oem", "odm" etc.
    27  #   - CUSTOM_IMAGE_PARTITION_SIZE
    28  #   - CUSTOM_IMAGE_FILE_SYSTEM_TYPE
    29  #   - CUSTOM_IMAGE_DICT_FILE, a text file defines a dictionary accepted by
    30  #     BuildImage() in tools/releasetools/build_image.py.
    31  #   - CUSTOM_IMAGE_MODULES, a list of module names you want to include in
    32  #     the image; Not only the module itself will be installed to proper path in
    33  #     the image, you can also piggyback additional files/directories with the
    34  #     module's LOCAL_PICKUP_FILES.
    35  #   - CUSTOM_IMAGE_COPY_FILES, a list of "<src>:<dest>" to be copied to the
    36  #     image. <dest> is relativ to the root of the image.
    37  #   - CUSTOM_IMAGE_SELINUX, set to "true" if the image supports selinux.
    38  #   - CUSTOM_IMAGE_SUPPORT_VERITY, set to "true" if the product supports verity.
    39  #   - CUSTOM_IMAGE_SUPPORT_VERITY_FEC, set to "true" if the product supports
    40  #     verity FEC (forward error correction).
    41  #   - CUSTOM_IMAGE_VERITY_BLOCK_DEVICE
    42  #   - CUSTOM_IMAGE_AVB_HASH_ENABLE, set to "true" to add AVB HASH footer.
    43  #   - CUSTOM_IMAGE_AVB_ADD_HASH_FOOTER_ARGS, additional args of AVB HASH footer.
    44  #   - CUSTOM_IMAGE_AVB_HASHTREE_ENABLE, set to "true" to add AVB HASHTREE
    45  #     footer.
    46  #   - CUSTOM_IMAGE_AVB_ADD_HASHTREE_FOOTER_ARGS, additional args of AVB
    47  #     HASHTREE footer.
    48  #   - CUSTOM_IMAGE_AVB_KEY_PATH, custom AVB signing key.
    49  #   - CUSTOM_IMAGE_AVB_ALGORITHM, custom AVB signing algorithm.
    50  #
    51  # To build all those images, run "make custom_images".
    52  
    53  ifneq ($(filter $(MAKECMDGOALS),custom_images),)
    54  
    55  .PHONY: custom_images
    56  
    57  custom_image_parameter_variables := \
    58    CUSTOM_IMAGE_MOUNT_POINT \
    59    CUSTOM_IMAGE_PARTITION_SIZE \
    60    CUSTOM_IMAGE_FILE_SYSTEM_TYPE \
    61    CUSTOM_IMAGE_DICT_FILE \
    62    CUSTOM_IMAGE_MODULES \
    63    CUSTOM_IMAGE_COPY_FILES \
    64    CUSTOM_IMAGE_SELINUX \
    65    CUSTOM_IMAGE_SUPPORT_VERITY \
    66    CUSTOM_IMAGE_SUPPORT_VERITY_FEC \
    67    CUSTOM_IMAGE_VERITY_BLOCK_DEVICE \
    68    CUSTOM_IMAGE_AVB_HASH_ENABLE \
    69    CUSTOM_IMAGE_AVB_ADD_HASH_FOOTER_ARGS \
    70    CUSTOM_IMAGE_AVB_HASHTREE_ENABLE \
    71    CUSTOM_IMAGE_AVB_ADD_HASHTREE_FOOTER_ARGS \
    72    CUSTOM_IMAGE_AVB_KEY_PATH \
    73    CUSTOM_IMAGE_AVB_ALGORITHM \
    74  
    75  # We don't expect product makefile to inherit/override PRODUCT_CUSTOM_IMAGE_MAKEFILES,
    76  # so we don't put it in the _product_var_list.
    77  $(foreach mk, $(PRODUCT_CUSTOM_IMAGE_MAKEFILES),\
    78    $(eval my_custom_imag_makefile := $(mk))\
    79    $(eval include $(BUILD_SYSTEM)/tasks/tools/build_custom_image.mk))
    80  
    81  endif