创建一个新的Android产品项目

转自：http://blog.csdn.net/jiajie961/article/details/5993126

从google网站上下载的android源代码编译时默认是编译google设定的产品，如果要开发自己的产品，
则需要重新定义一个产品项目，过程如下：
首先我们定义产品的规格，举例如下：
公司名称 ardent
产品名称 MTP
主板名称 merlin
然后安装下面的步骤新建产品项目：
(1)在源代码目录下创建一个用户目录
mkdir vendor

(2)在用户目录下创建一个公司目录
mkdir vendor/merlin

(3)在公司目录下创建一个products目录
mkdir vendor/merlin/products

(4)在上面创建的products下创建一个产品makefile文件MTP.mk，内容如下：
PRODUCT_PACKAGES := /
   AlarmClock /
   Email /
   Fallback /
   Launcher2 /
   Music /
   Camera /
   Settings /
   LatinIME /
   NotePad /
   SoundRecorder /
   Bluetooth /
   CertInstaller /
   DeskClock

$(call inherit-product, $(SRC_TARGET_DIR)/product/core.mk)
#
# Overrides
PRODUCT_MANUFACTURER := ardent
PRODUCT_BRAND := ardent
PRODUCT_NAME := MTP
PRODUCT_MODEL := MultiMedia Touch Phone
PRODUCT_DEVICE := merlin
PRODUCT_LOCALES := zh_CN
产品makefile文件的编写有一套规则，详细情况见此文后面的补充内容。

(5)在vendor/merlin/products目录下创建一个AndroidProducts.mk文件，定义Android产品配置文件的路径，具体如下：
PRODUCT_MAKEFILES := /
 $(LOCAL_DIR)/MTP.mk

(6)在公司目录下创建一个主板目录
mkdir vendor/ardent/merlin

(7)在主板目录下新建一个主板配置文件BoardConfig.mk，内容如下：
TARGET_NO_BOOTLOADER := true
TARGET_NO_KERNEL := true
TARGET_CPU_ABI := armeabi
BOARD_USES_GENERIC_AUDIO := true
USE_CAMERA_STUB := true

(8)如果你希望修改系统属性，则可以在主板目录下新建一个system.prop文件，该文件中可以修改系统属性，举例如下：
# system.prop for 
# This overrides settings in the products/generic/system.prop file
#
# rild.libpath=/system/lib/libreference-ril.so
# rild.libargs=-d /dev/ttyS0

(9)在主板目录下建议一个Android的主板配置文件AndroidBoard.mk，此文件是编译系统接口文件，内容如下：
# make file for new hardware from 
#
LOCAL_PATH := $(call my-dir)

#
# this is here to use the pre-built kernel
ifeq ($(TARGET_PREBUILT_KERNEL),)
TARGET_PREBUILT_KERNEL := $(LOCAL_PATH)/kernel
endif

file := $(INSTALLED_KERNEL_TARGET)
ALL_PREBUILT += $(file)
$(file): $(TARGET_PREBUILT_KERNEL) | $(ACP)
      $(transform-prebuilt-to-target)

#
# no boot loader, so we don't need any of that stuff..  
#
LOCAL_PATH := vendor/ardent/merlin
include $(CLEAR_VARS)
#
# include more board specific stuff here? Such as Audio parameters.      
#

(10)编译新的项目
. build/envsetup.sh
make PRODUCT-MTP-user

补充内容：
(1)上面的新建的几个文件的编写可以参考build/target/board/generic目录下的AndroidBoard.mk，BoardConfig.mk和system.prop

(2)产品makefile的编写规则，变量定义解释如下：
PRODUCT_NAME    终端用户可见的产品名称，对应到“Settings“中的“About the phone”信息     
PRODUCT_MODEL    End-user-visible name for the end product     
PRODUCT_LOCALES 1个以空格分隔开的两个字母的语言码加上2字节的国家码的列表，影响到"Settings"中的语言，时间，日期和货币格式设置，
                               举例：en_GB de_DE es_ES fr_CA
PRODUCT_PACKAGES 需要安装的APK应用程序列表
PRODUCT_DEVICE    工作设计名称，即主板名称
PRODUCT_MANUFACTURER    生产厂家
PRODUCT_BRAND    软件设计针对的客户品牌     
PRODUCT_PROPERTY_OVERRIDES    以"key=value"为格式的属性列表
PRODUCT_COPY_FILES 文件复制列表，格式为“原文件路径：目的文件路径”，编译过程中会按照此规则复制文件     
PRODUCT_OTA_PUBLIC_KEYS 产品的OTA公共密匙列表
PRODUCT_POLICY    声明此产品使用的政策     
PRODUCT_PACKAGE_OVERLAYS 指示是否使用默认资源或添加任何产品特定的资源，例如：vendor/acme/overlay
PRODUCT_CONTRIBUTORS_FILE HTML文件中包含项目的贡献者     
PRODUCT_TAGS 以空格分隔开的指定产品关键词列表

以下转自：http://blog.csdn.net/ccwwff/article/details/5737812

ANDROID Porting系列二、配置一个新产品

详细说明

下面的步骤描述了如何配置新的移动设备和产品的makefile运行android。

1.         目录//vendor/创建一个公司目录

 mkdir vendor/<company_name>

2.         创建一个目录下的公司与您在步骤1中创建产品目录.

 mkdir vendor/<company_name>/products/

3.         创建一个特定于产品的 makefile,

调用 

vendor/<company_name>/products/<first_product_name>.mk

, 这至少包括以下代码：

 $(call inherit-product, $(SRC_TARGET_DIR)/product/generic.mk)

 #

 # Overrides

 PRODUCT_NAME := <first_product_name>

 PRODUCT_DEVICE := <board_name>

4.         附加产品特定的变量可以被添加到这个Product Definition文件.

5.         在产品目录中，创建一个AndroidProducts.mk文件指向（并找到负责）个别产品make files。

 #

 # This file should set PRODUCT_MAKEFILES to a list of product makefiles

 # to expose to the build system. LOCAL_DIR will already be set to

 # the directory containing this file.

  #

 # This file may not rely on the value of any variable other than

 # LOCAL_DIR; do not use any conditionals, and do not look up the

 # value of any variable that isn't set in this file or in a file that

 # it includes.

 #

  PRODUCT_MAKEFILES := /

   $(LOCAL_DIR)/first_product_name.mk /

6.         创建board-specific目录下贵公司的目录与相匹配的PRODUCT_DEVICE<board_name>引用变量在特定产品作出上述文件。这包括任何使用本产品访问product-specific make file.

 mkdir vendor/<company_name>/<board_name>

7.         创建一个在上一步中创建文件的目录BoardConfig.mk (vendor/<company_name>/<board_name>). 

 # These definitions override the defaults in config/config.make for <board_name>

 #

 # TARGET_NO_BOOTLOADER := false

 #

 TARGET_USE_GENERIC_AUDIO := true

8.         如果你想修改系统属性，创建一个system.prop文件your <board_name> directory(vendor/<company_name>/<board_name>).

 # system.prop for 

  # This overrides settings in the products/generic/system.prop file

 #

 # rild.libpath=/system/lib/libreference-ril.so

 # rild.libargs=-d /dev/ttyS0

9.         products/AndroidProducts.mk添加一个指向<second_product_name>.mk,.

 PRODUCT_MAKEFILES := /

   $(LOCAL_DIR)/first_product_name.mk /

   $(LOCAL_DIR)/second_product_name.mk

10.     一个Android.mk文件必须包含在供应商/ <company_name> / <board_name>至少有下面的代码.

 # make file for new hardware from 

  #

 LOCAL_PATH := $(call my-dir)

 #

 # this is here to use the pre-built kernel

 ifeq ($(TARGET_PREBUILT_KERNEL),)

 TARGET_PREBUILT_KERNEL := $(LOCAL_PATH)/kernel

 endif

 #

 file := $(INSTALLED_KERNEL_TARGET)

 ALL_PREBUILT += $(file)

 $(file): $(TARGET_PREBUILT_KERNEL) | $(ACP)

          $(transform-prebuilt-to-target)

 #

 # no boot loader, so we don't need any of that stuff.. 

  #

 LOCAL_PATH := vendor/<company_name>/<board_name>

 #

 include $(CLEAR_VARS)

 #

 # include more board specific stuff here? Such as Audio parameters.     

  #

11.     要创建一个相同的板第二个产品，创建第二个product-specific make file called vendor/company_name/products/<second_product_name>.mkthat includes:

 $(call inherit-product, $(SRC_TARGET_DIR)/product/generic.mk)

 #

 # Overrides

 PRODUCT_NAME := <second_product_name>

 PRODUCT_DEVICE := <board_name>

到现在为止，你应该有两个新产品，名为<first_product_name>和<company_name>相关<second_product_name>。为了验证一个产品是正确配置（<first_product_name>，例如），执行以下命令：

 . build/envsetup.sh

 make PRODUCT-<first_product_name>-user

你应该找到新的建设二进制文件位于out/target/product/<board_name>。

 

新产品文件树

该文件树下面说明你自己的系统应该完成上述步骤。

·                                 

<company_name>

o                                                        

<board_name>

§                                                                                 

Android.mk

§                                                                                 

product_config.mk

§                                                                                 

system.prop

o                                                        

products

§                                                                                 

AndroidProducts.mk

§                                                                                 

<first_product_name>.mk

§                                                                                 

<second_product_name>.mk

产品定义文件

特定产品的变量定义在产品定义文件。一个产品的定义文件可以继承其他产品定义文件，从而减少了需要复制和简化维护。

变量在定义文件保持产品包括：

Parameter	Description	Example
PRODUCT_NAME	最终用户可见名称的整体产品。出现在“关于手机”信息。
PRODUCT_MODEL	最终用户可见的最终产品名称
PRODUCT_LOCALES	A space-separated list of two-letter language code, two-letter country code pairs that describe several settings for the user, such as the UI language and time, date and currency formatting. The first locale listed in PRODUCT_LOCALES is is used if the locale has never been set before.	en_GB de_DE es_ES fr_CA
PRODUCT_PACKAGES	Lists the APKs to install.	Calendar Contacts
PRODUCT_DEVICE	Name of the industrial design	dream
PRODUCT_MANUFACTURER	Name of the manufacturer	acme
PRODUCT_BRAND	The brand (e.g., carrier) the software is customized for, if any
PRODUCT_PROPERTY_OVERRIDES	List of property assignments in the format "key=value"
PRODUCT_COPY_FILES	List of words like  source_path:destination_path . The file at the source path should be copied to the destination path when building this product. The rules for the copy steps are defined in config/Makefile
PRODUCT_OTA_PUBLIC_KEYS	List of OTA public keys for the product
PRODUCT_POLICY	Indicate which policy this product should use
PRODUCT_PACKAGE_OVERLAYS	Indicate whether to use default resources or add any product specific overlays	vendor/acme/overlay
PRODUCT_CONTRIBUTORS_FILE	HTML file containing the contributors to the project.
PRODUCT_TAGS	list of space-separated words for a given product

下面的代码段演示了一个典型的产品定义文件。

$(call inherit-product, build/target/product/generic.mk)

#Overrides

PRODUCT_NAME := MyDevice

PRODUCT_MANUFACTURER := acme

PRODUCT_BRAND := acme_us

PRODUCT_LOCALES := en_GB es_ES fr_FR

PRODUCT_PACKAGE_OVERLAYS := vendor/acme/overlay

--------------------------------------------------------------------------------------------------------------