Gitiles
Code Review Sign In
review.blissroms.org / platform_manifest / refs/heads/master / . / README.mkdn
blob: 9a4fa8008e2651688b3e9c23d35b08418a4c3230 [file] [log] [blame]
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]1<img src="https://raw.github.com/BlissRoms/platform_manifest/mm6.0/bliss-logo.png">
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]2
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]3Getting Started
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]4---------------
5
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]6To get started with Android/Bliss, you'll need to get
7familiar with [Git and Repo](http://source.android.com/source/using-repo.html).
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]8
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]9To initialize your local repository using the Bliss trees, use this command:
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]10
Lars Greiss1bdc5e22013-11-27 19:49:17 +0100[diff] [blame]11
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]12 repo init -u https://github.com/BlissRoms/platform_manifest.git -b mm6.0
Lars Greiss1bdc5e22013-11-27 19:49:17 +0100[diff] [blame]13
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]14Then to sync up:
Lars Greiss1bdc5e22013-11-27 19:49:17 +0100[diff] [blame]15
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]16 repo sync -j#
Lars Greiss1bdc5e22013-11-27 19:49:17 +0100[diff] [blame]17
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]18This(j#) depends on number of cpu cores - use just "repo sync" if you are unsure.
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]19
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]20To build for your device.
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]21
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]22. build/envsetup.sh
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]23
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]24breakfast `device name here`
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]25
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]26brunch `device name here`
27
28or make it all in one line.
29
30. build/envsetup.sh && breakfast `device name here` && brunch *device name here*
31
32For more information on this Github Organization and how it is structured,
33please [read the wiki article](http://wiki.cyanogenmod.org/w/Github_Organization)
34
35***
36
37Using Build Script
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]38------------------
39
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]40run command ". build.sh" and follow the command prompts.
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]41
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]42
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]43GERRIT
44------
45review.blissroms.com
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]46
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]47If you would like to contribute to the blissrom project submit patches to:
48`review.blissroms.com`. Then head into the project and clone it locally make changes and push back to bliss review.
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]49
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]50HOW TO SUBMIT TO OUR GERRIT:
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]51
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]52First and foremost, setup your github with out Gerrit.
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]53
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]54Clone the repo you would like to commit to from the Gerrit [Project List](http://review.blissroms.com:8081/#/admin/projects/)
55 -Select from the list and copy clone command line.
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]56
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]57Make sure you have git review installed
58 - sudo apt-get install git-review
59
60Make sure you are on the correct branch----mm6.0
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]61
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]62Make your change and commit it
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]63
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]64Now just type git review, if it does not have the remote yet it will automatically add it and just answer yes to its questions. It will push to the gerrit for you.
Lars Greissfd74a6b2013-11-01 02:00:14 +0100[diff] [blame]65
Dark Eyes777e3e02015-12-04 14:30:35 -0500[diff] [blame]66BLISS BUILD FLAGS
67-----------------
68
69These can be added to your device trees BoardConfig.mk
70
71`BLISS_STRICT:= true` "run strict aliasing"
72
73`BLISS_O3 := true` run "O3 optimizations on build"
74
75`BLISS_GRAPHITE := true` "run Graphite optimiations on build"
76
77`BLISS_KRAIT := true` "run krait optimizations on build-- CPU specific, please verify if you can use this"
78
79`BLISS_PIPE := true` "This flag actually has no effect on the generated code, but it makes the compilation process faster."
80
81`TARGET_TC_ROM := "@@"` Specify toolchain for Rom to be compiled with
82
83`TARGET_TC_KERNEL := "@@"` Specify toolchain for kernel to be complied with.
84
85@@= Toolchains are located in prebuilts/gcc/linux-x86/arm You only need to specify the end number be it 4.8-sm for 4.8 SaberMod Toolchain, this goes for both ROM and KERNEL.
86
87If you use TARGET_TC_ROM and/or TARGET_TC_KERNEL, please add the following to BoardConfig.mk as well
88
89`TARGET_GCC_VERSION_EXP := $(TARGET_TC_ROM)`
90
91`TARGET_KERNEL_CUSTOM_TOOLCHAIN := $(TARGET_TC_KERNEL)`
92
93Last but not least, add this line to end of BoardConfig.mk `-include vendor/bliss/config/sm.mk`