Gitiles
Code Review Sign In
review.blissroms.org / Documentation / refs/heads/docs / . / getting-started / build / index.html
blob: 6a14461649e7796161865f304f4d2ce8aa04a69c [file] [log] [blame]
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]1<!DOCTYPE html>
2<html lang="en" class="h-full">
3<head>
4 <meta charset="UTF-8">
5 <meta name="viewport" content="width=device-width,initial-scale=1">
Retype GitHub Action27a50c22023-06-04 04:12:21 +0000[diff] [blame]6 <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="3.0.1.739167138589">
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]7
8 <!-- See retype.com -->
Retype GitHub Actioncb0c3fd2023-06-03 09:57:28 +0000[diff] [blame]9 <meta name="generator" content="Retype 3.0.1">
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]10
11 <!-- Primary Meta Tags -->
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]12 <title>Build Initialization - BlissRoms Docs</title>
13 <meta name="title" content="Build Initialization - BlissRoms Docs">
14 <meta name="description" content="Create a directory for the source code:" />
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]15
16 <!-- Canonical -->
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]17 <link rel="canonical" href="https://docs.blissroms.org/getting-started/build/" />
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]18
19 <!-- Open Graph / Facebook -->
20 <meta property="og:type" content="website">
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]21 <meta property="og:url" content="https://docs.blissroms.org/getting-started/build/">
22 <meta property="og:title" content="Build Initialization - BlissRoms Docs">
23 <meta property="og:description" content="Create a directory for the source code:">
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]24
25 <!-- Twitter -->
26 <meta property="twitter:card" content="summary_large_image">
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]27 <meta property="twitter:url" content="https://docs.blissroms.org/getting-started/build/">
28 <meta property="twitter:title" content="Build Initialization - BlissRoms Docs">
29 <meta property="twitter:description" content="Create a directory for the source code:">
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]30
31 <script>(function () { var el = document.documentElement, m = localStorage.getItem("doc_theme"), wm = window.matchMedia; if (m === "dark" || (!m && wm && wm("(prefers-color-scheme: dark)").matches)) { el.classList.add("dark") } else { el.classList.remove("dark") } })();</script>
32
Retype GitHub Action27a50c22023-06-04 04:12:21 +0000[diff] [blame]33 <link href="../../resources/css/retype.css?v=3.0.1.739167138589" rel="stylesheet" />
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]34
Retype GitHub Action27a50c22023-06-04 04:12:21 +0000[diff] [blame]35 <script type="text/javascript" src="../../resources/js/config.js?v=3.0.1.739167138589" data-turbo-eval="false" defer></script>
Retype GitHub Actioncb0c3fd2023-06-03 09:57:28 +0000[diff] [blame]36 <script type="text/javascript" src="../../resources/js/retype.js?v=3.0.1" data-turbo-eval="false" defer></script>
Retype GitHub Action27a50c22023-06-04 04:12:21 +0000[diff] [blame]37 <script id="lunr-js" type="text/javascript" src="../../resources/js/lunr.js?v=3.0.1.739167138589" data-turbo-eval="false" defer></script>
38 <script id="prism-js" type="text/javascript" src="../../resources/js/prism.js?v=3.0.1.739167138589" defer></script>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]39</head>
40<body>
41 <div id="docs-app" class="relative text-base antialiased text-gray-700 bg-white font-body dark:bg-dark-850 dark:text-dark-300">
42 <div class="absolute bottom-0 left-0 bg-gray-100 dark:bg-dark-800" style="top: 5rem; right: 50%"></div>
43
44 <header id="docs-site-header" class="sticky top-0 z-30 flex w-full h-16 bg-white border-b border-gray-200 md:h-20 dark:bg-dark-850 dark:border-dark-650">
45 <div class="container relative flex items-center justify-between grow pr-6 md:justify-start">
46 <!-- Mobile menu button skeleton -->
47 <button v-cloak class="skeleton docs-mobile-menu-button flex items-center justify-center shrink-0 overflow-hidden dark:text-white focus:outline-none rounded-full w-10 h-10 ml-3.5 md:hidden"><svg xmlns="http://www.w3.org/2000/svg" class="mb-px shrink-0" width="24" height="24" viewBox="0 0 24 24" role="presentation" style="margin-bottom: 0px;"><g fill="currentColor"><path d="M2 4h20v2H2zM2 11h20v2H2zM2 18h20v2H2z"></path></g></svg></button>
48 <div v-cloak id="docs-sidebar-toggle"></div>
49
50 <!-- Logo -->
51 <div class="flex items-center justify-between h-full py-2 md:w-75">
52 <div class="flex items-center px-2 md:px-6">
53 <a id="docs-site-logo" href="../../" class="flex items-center leading-snug text-2xl">
54 <span class="dark:text-white font-semibold line-clamp-1 md:line-clamp-2">BlissRoms</span>
55 </a><span class="hidden px-2 py-1 ml-4 text-sm font-semibold leading-none text-root-logo-label-text bg-root-logo-label-bg rounded-sm md:inline-block">Docs</span>
56 </div>
57
58 <span class="hidden h-8 border-r md:inline-block dark:border-dark-650"></span>
59 </div>
60
61 <div class="flex justify-between md:grow">
62 <!-- Top Nav -->
63 <nav class="hidden md:flex">
64 <ul class="flex flex-col mb-4 md:pl-16 md:mb-0 md:flex-row md:items-center">
65 <li class="mr-6">
66 <a class="py-2 md:mb-0 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-blue-500 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-200" href="../../">
67 <svg xmlns="http://www.w3.org/2000/svg" class="mb-px mr-1" width="18" height="18" viewBox="0 0 24 24" role="presentation">
68 <g fill="currentColor">
Retype GitHub Actioncb0c3fd2023-06-03 09:57:28 +0000[diff] [blame]69 <path d="M11.03 2.59a1.501 1.501 0 0 1 1.94 0l7.5 6.363a1.5 1.5 0 0 1 .53 1.144V19.5a1.5 1.5 0 0 1-1.5 1.5h-5.75a.75.75 0 0 1-.75-.75V14h-2v6.25a.75.75 0 0 1-.75.75H4.5A1.5 1.5 0 0 1 3 19.5v-9.403c0-.44.194-.859.53-1.144ZM12 3.734l-7.5 6.363V19.5h5v-6.25a.75.75 0 0 1 .75-.75h3.5a.75.75 0 0 1 .75.75v6.25h5v-9.403Z"/>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]70 </g>
71 </svg>
72 <span>Home</span>
73 </a>
74 </li>
75
76 </ul>
77 </nav>
78
79 <!-- Header Right Skeleton -->
80 <div v-cloak class="flex justify-end grow skeleton">
81
82 <!-- Search input mock -->
83 <div class="relative hidden w-40 lg:block lg:max-w-sm lg:ml-auto">
84 <div class="absolute flex items-center justify-center h-full pl-3 dark:text-dark-300">
85 <svg xmlns="http://www.w3.org/2000/svg" class="icon-base" width="16" height="16" viewBox="0 0 24 24" aria-labelledby="icon" role="presentation" style="margin-bottom: 1px;"><g fill="currentColor" ><path d="M21.71 20.29l-3.68-3.68A8.963 8.963 0 0020 11c0-4.96-4.04-9-9-9s-9 4.04-9 9 4.04 9 9 9c2.12 0 4.07-.74 5.61-1.97l3.68 3.68c.2.19.45.29.71.29s.51-.1.71-.29c.39-.39.39-1.03 0-1.42zM4 11c0-3.86 3.14-7 7-7s7 3.14 7 7c0 1.92-.78 3.66-2.04 4.93-.01.01-.02.01-.02.01-.01.01-.01.01-.01.02A6.98 6.98 0 0111 18c-3.86 0-7-3.14-7-7z" ></path></g></svg>
86 </div>
87
88 <input class="w-full h-10 transition-colors duration-200 ease-in bg-gray-200 border border-transparent rounded md:text-sm hover:bg-white hover:border-gray-300 focus:outline-none focus:bg-white focus:border-gray-500 dark:bg-dark-600 dark:border-dark-600 placeholder-gray-400 dark:placeholder-dark-400"
89 style="padding: 0.625rem 0.75rem 0.625rem 2rem" type="text" placeholder="Search" />
90 </div>
91
92 <!-- Mobile search button mock -->
93 <div class="flex items-center justify-center w-10 h-10 lg:hidden">
94 <svg xmlns="http://www.w3.org/2000/svg" class="shrink-0 icon-base" width="20" height="20" viewBox="0 0 24 24" aria-labelledby="icon" role="presentation" style="margin-bottom: 0px;"><g fill="currentColor" ><path d="M21.71 20.29l-3.68-3.68A8.963 8.963 0 0020 11c0-4.96-4.04-9-9-9s-9 4.04-9 9 4.04 9 9 9c2.12 0 4.07-.74 5.61-1.97l3.68 3.68c.2.19.45.29.71.29s.51-.1.71-.29c.39-.39.39-1.03 0-1.42zM4 11c0-3.86 3.14-7 7-7s7 3.14 7 7c0 1.92-.78 3.66-2.04 4.93-.01.01-.02.01-.02.01-.01.01-.01.01-.01.02A6.98 6.98 0 0111 18c-3.86 0-7-3.14-7-7z" ></path></g></svg>
95 </div>
96
97 <!-- Dark mode switch placehokder -->
98 <div class="w-10 h-10 lg:ml-2"></div>
99
100 <!-- History button mock -->
101 <div class="flex items-center justify-center w-10 h-10" style="margin-right: -0.625rem;">
102 <svg xmlns="http://www.w3.org/2000/svg" class="shrink-0 icon-base" width="22" height="22" viewBox="0 0 24 24" aria-labelledby="icon" role="presentation" style="margin-bottom: 0px;"><g fill="currentColor" ><g ><path d="M12.01 6.01c-.55 0-1 .45-1 1V12a1 1 0 00.4.8l3 2.22a.985.985 0 001.39-.2.996.996 0 00-.21-1.4l-2.6-1.92V7.01c.02-.55-.43-1-.98-1z"></path><path d="M12.01 1.91c-5.33 0-9.69 4.16-10.05 9.4l-.29-.26a.997.997 0 10-1.34 1.48l1.97 1.79c.19.17.43.26.67.26s.48-.09.67-.26l1.97-1.79a.997.997 0 10-1.34-1.48l-.31.28c.34-4.14 3.82-7.41 8.05-7.41 4.46 0 8.08 3.63 8.08 8.09s-3.63 8.08-8.08 8.08c-2.18 0-4.22-.85-5.75-2.4a.996.996 0 10-1.42 1.4 10.02 10.02 0 007.17 2.99c5.56 0 10.08-4.52 10.08-10.08.01-5.56-4.52-10.09-10.08-10.09z"></path></g></g></svg>
103 </div>
104 </div>
105
106 <div v-cloak class="flex justify-end grow">
107 <div id="docs-mobile-search-button"></div>
108 <doc-search-desktop></doc-search-desktop>
109
110 <doc-theme-switch class="lg:ml-2"></doc-theme-switch>
111 <doc-history></doc-history>
112 </div>
113 </div>
114 </div>
115 </header>
116
117 <div class="container relative flex bg-white">
118 <!-- Sidebar Skeleton -->
119 <div v-cloak class="fixed flex flex-col shrink-0 duration-300 ease-in-out bg-gray-100 border-gray-200 sidebar top-20 w-75 border-r h-screen md:sticky transition-transform skeleton dark:bg-dark-800 dark:border-dark-650">
120
121 <!-- Render this div, if config.showSidebarFilter is `true` -->
122 <div class="flex items-center h-16 px-6">
123 <input class="w-full h-8 px-3 py-2 transition-colors duration-200 ease-linear bg-white border border-gray-200 rounded shadow-none text-sm focus:outline-none focus:border-gray-600 dark:bg-dark-600 dark:border-dark-600" type="text" placeholder="Filter" />
124 </div>
125
126 <div class="pl-6 mb-4 mt-1">
127 <div class="w-32 h-3 mb-4 bg-gray-200 rounded-full loading dark:bg-dark-600"></div>
128 <div class="w-48 h-3 mb-4 bg-gray-200 rounded-full loading dark:bg-dark-600"></div>
129 <div class="w-40 h-3 mb-4 bg-gray-200 rounded-full loading dark:bg-dark-600"></div>
130 <div class="w-32 h-3 mb-4 bg-gray-200 rounded-full loading dark:bg-dark-600"></div>
131 <div class="w-48 h-3 mb-4 bg-gray-200 rounded-full loading dark:bg-dark-600"></div>
132 <div class="w-40 h-3 mb-4 bg-gray-200 rounded-full loading dark:bg-dark-600"></div>
133 </div>
134
135 <div class="shrink-0 mt-auto bg-transparent dark:border-dark-650">
136 <a class="flex items-center justify-center flex-nowrap h-16 text-gray-400 dark:text-dark-400 hover:text-gray-700 dark:hover:text-dark-300 transition-colors duration-150 ease-in docs-powered-by" target="_blank" href="https://retype.com/" rel="noopener">
137 <span class="text-xs whitespace-nowrap">Powered by</span>
138 <svg xmlns="http://www.w3.org/2000/svg" class="ml-2" fill="currentColor" width="96" height="20" overflow="visible"><path d="M0 0v20h13.59V0H0zm11.15 17.54H2.44V2.46h8.71v15.08zM15.8 20h2.44V4.67L15.8 2.22zM20.45 6.89V20h2.44V9.34z"/><g><path d="M40.16 8.44c0 1.49-.59 2.45-1.75 2.88l2.34 3.32h-2.53l-2.04-2.96h-1.43v2.96h-2.06V5.36h3.5c1.43 0 2.46.24 3.07.73s.9 1.27.9 2.35zm-2.48 1.1c.26-.23.38-.59.38-1.09 0-.5-.13-.84-.4-1.03s-.73-.28-1.39-.28h-1.54v2.75h1.5c.72 0 1.2-.12 1.45-.35zM51.56 5.36V7.2h-4.59v1.91h4.13v1.76h-4.13v1.92h4.74v1.83h-6.79V5.36h6.64zM60.09 7.15v7.48h-2.06V7.15h-2.61V5.36h7.28v1.79h-2.61zM70.81 14.64h-2.06v-3.66l-3.19-5.61h2.23l1.99 3.45 1.99-3.45H74l-3.19 5.61v3.66zM83.99 6.19c.65.55.97 1.4.97 2.55s-.33 1.98-1 2.51-1.68.8-3.04.8h-1.23v2.59h-2.06V5.36h3.26c1.42 0 2.45.28 3.1.83zm-1.51 3.65c.25-.28.37-.69.37-1.22s-.16-.92-.48-1.14c-.32-.23-.82-.34-1.5-.34H79.7v3.12h1.38c.68 0 1.15-.14 1.4-.42zM95.85 5.36V7.2h-4.59v1.91h4.13v1.76h-4.13v1.92H96v1.83h-6.79V5.36h6.64z"/></g></svg>
139 </a>
140 </div>
141 </div>
142
143 <!-- Sidebar component -->
144 <doc-sidebar v-cloak>
145 <template #sidebar-footer>
146 <div class="shrink-0 mt-auto border-t md:bg-transparent md:border-none dark:border-dark-650">
147
148 <div class="py-3 px-6 md:hidden border-b dark:border-dark-650">
149 <nav>
150 <ul class="flex flex-wrap justify-center items-center">
151 <li class="mr-6">
152 <a class="block py-1 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-blue-500 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-200" href="../../">
153 <svg xmlns="http://www.w3.org/2000/svg" class="mb-px mr-1" width="18" height="18" viewBox="0 0 24 24" role="presentation">
154 <g fill="currentColor">
Retype GitHub Actioncb0c3fd2023-06-03 09:57:28 +0000[diff] [blame]155 <path d="M11.03 2.59a1.501 1.501 0 0 1 1.94 0l7.5 6.363a1.5 1.5 0 0 1 .53 1.144V19.5a1.5 1.5 0 0 1-1.5 1.5h-5.75a.75.75 0 0 1-.75-.75V14h-2v6.25a.75.75 0 0 1-.75.75H4.5A1.5 1.5 0 0 1 3 19.5v-9.403c0-.44.194-.859.53-1.144ZM12 3.734l-7.5 6.363V19.5h5v-6.25a.75.75 0 0 1 .75-.75h3.5a.75.75 0 0 1 .75.75v6.25h5v-9.403Z"/>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]156 </g>
157 </svg>
158 <span>Home</span>
159 </a>
160 </li>
161
162 </ul>
163 </nav>
164 </div>
165
166 <a class="flex items-center justify-center flex-nowrap h-16 text-gray-400 dark:text-dark-400 hover:text-gray-700 dark:hover:text-dark-300 transition-colors duration-150 ease-in docs-powered-by" target="_blank" href="https://retype.com/" rel="noopener">
167 <span class="text-xs whitespace-nowrap">Powered by</span>
168 <svg xmlns="http://www.w3.org/2000/svg" class="ml-2" fill="currentColor" width="96" height="20" overflow="visible"><path d="M0 0v20h13.59V0H0zm11.15 17.54H2.44V2.46h8.71v15.08zM15.8 20h2.44V4.67L15.8 2.22zM20.45 6.89V20h2.44V9.34z"/><g><path d="M40.16 8.44c0 1.49-.59 2.45-1.75 2.88l2.34 3.32h-2.53l-2.04-2.96h-1.43v2.96h-2.06V5.36h3.5c1.43 0 2.46.24 3.07.73s.9 1.27.9 2.35zm-2.48 1.1c.26-.23.38-.59.38-1.09 0-.5-.13-.84-.4-1.03s-.73-.28-1.39-.28h-1.54v2.75h1.5c.72 0 1.2-.12 1.45-.35zM51.56 5.36V7.2h-4.59v1.91h4.13v1.76h-4.13v1.92h4.74v1.83h-6.79V5.36h6.64zM60.09 7.15v7.48h-2.06V7.15h-2.61V5.36h7.28v1.79h-2.61zM70.81 14.64h-2.06v-3.66l-3.19-5.61h2.23l1.99 3.45 1.99-3.45H74l-3.19 5.61v3.66zM83.99 6.19c.65.55.97 1.4.97 2.55s-.33 1.98-1 2.51-1.68.8-3.04.8h-1.23v2.59h-2.06V5.36h3.26c1.42 0 2.45.28 3.1.83zm-1.51 3.65c.25-.28.37-.69.37-1.22s-.16-.92-.48-1.14c-.32-.23-.82-.34-1.5-.34H79.7v3.12h1.38c.68 0 1.15-.14 1.4-.42zM95.85 5.36V7.2h-4.59v1.91h4.13v1.76h-4.13v1.92H96v1.83h-6.79V5.36h6.64z"/></g></svg>
169 </a>
170 </div>
171 </template>
172 </doc-sidebar>
173
174 <div class="grow min-w-0 dark:bg-dark-850">
175 <!-- Render "toolbar" template here on api pages --><!-- Render page content -->
176 <div class="flex">
Retype GitHub Actioncb0c3fd2023-06-03 09:57:28 +0000[diff] [blame]177 <div class="min-w-0 p-4 grow md:px-16">
178 <main class="relative pb-12 lg:pt-2">
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]179 <div class="docs-markdown" id="docs-content">
180 <!-- Rendered if sidebar right is enabled -->
181 <div id="docs-sidebar-right-toggle"></div>
182
183 <!-- Page content -->
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]184<doc-anchor-target id="build-initialization" class="break-words">
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]185 <h1>
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]186 <doc-anchor-trigger class="header-anchor-trigger" to="#build-initialization">#</doc-anchor-trigger>
187 <span>Build Initialization</span>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]188 </h1>
189</doc-anchor-target>
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]190<doc-anchor-target id="initializing-repository">
191 <h2>
192 <doc-anchor-trigger class="header-anchor-trigger" to="#initializing-repository">#</doc-anchor-trigger>
193 <span>Initializing Repository</span>
194 </h2>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]195</doc-anchor-target>
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]196<p>Create a directory for the source code:</p>
197<div class="codeblock-wrapper"><doc-codeblock>
198<pre class="language-bash"><code v-pre class="language-bash">mkdir -p ~/bliss/typhoon
199cd ~/bliss/typhoon</code></pre>
200</doc-codeblock></div>
201<p>Before downloading the source code, let&#x27;s configure your Git identity. Replace the example information with your own:</p>
202<div class="codeblock-wrapper"><doc-codeblock>
203<pre class="language-bash"><code v-pre class="language-bash">git config --global user.email &quot;john.appleseed@example.com&quot;
204git config --global user.name &quot;John Appleseed&quot;</code></pre>
205</doc-codeblock></div>
206<p>Now we can proceed with initializing the repository. Run the following commands to specify the manifest and version:</p>
207<p><strong>Initialize repo:</strong></p>
208<div class="codeblock-wrapper"><doc-codeblock>
209<pre class="language-bash"><code v-pre class="language-bash">repo init -u https://github.com/BlissRoms/platform_manifest.git -b typhoon-qpr2 --git-lfs</code></pre>
210</doc-codeblock></div>
211<p><strong>Sync the repository:</strong></p>
212<div class="codeblock-wrapper"><doc-codeblock>
213<pre class="language-bash"><code v-pre class="language-bash">repo sync -c --force-sync --no-tags --no-clone-bundle -j10 --optimized-fetch --prune</code></pre>
214</doc-codeblock></div>
215<p>These commands initialize the repository using the BlissRoms manifest for the &quot;typhoon-qpr2&quot; branch and sync the repository, fetching the necessary source code and dependencies.</p>
216<doc-anchor-target id="building">
217 <h2>
218 <doc-anchor-trigger class="header-anchor-trigger" to="#building">#</doc-anchor-trigger>
219 <span>Building</span>
220 </h2>
221</doc-anchor-target>
222<p>To start the build process, execute the following commands:</p>
223<div class="codeblock-wrapper"><doc-codeblock>
224<pre class="language-bash"><code v-pre class="language-bash">. build/envsetup.sh
225blissify options deviceCodename</code></pre>
226</doc-codeblock></div>
227<p><strong>Options:</strong></p>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]228<ul>
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]229<li><code v-pre>BLISS_BUILD_VARIANT</code> - Specifies the type of extra apps and services to include in the build. The default variant is VANILLA.</li>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]230</ul>
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]231<div class="codeblock-wrapper"><doc-codeblock>
232<pre class="language-bash"><code v-pre class="language-bash">-h | --help: Shows the help dialog
233-c | --clean: Clean up before running the build
234-d | --devclean: Clean up device only before running the build
235-v | --vanilla: Build with no added app store solution (default option)
236-p | --pixelgapps: Build with Pixel Gapps (only for Pixel Users)
237-g | --gapps: Build with Minimal Google Play Services added
238-f | --foss: Build with FOSS (arm64-v8a) app store solutions added (requires vendor/foss)</code></pre>
239</doc-codeblock></div>
240<p><strong>Examples:</strong></p>
241<ul>
242<li><strong>To build with gapps:</strong></li>
243</ul>
244<div class="codeblock-wrapper"><doc-codeblock>
245<pre class="language-bash"><code v-pre class="language-bash">blissify -g deviceCodename</code></pre>
246</doc-codeblock></div>
247<ul>
248<li><strong>To build with FOSS:</strong></li>
249</ul>
250<div class="codeblock-wrapper"><doc-codeblock>
251<pre class="language-bash"><code v-pre class="language-bash">blissify -f deviceCodename</code></pre>
252</doc-codeblock></div>
253<ul>
254<li><strong>To build with gapps and perform deviceclean:</strong></li>
255</ul>
256<div class="codeblock-wrapper"><doc-codeblock>
257<pre class="language-bash"><code v-pre class="language-bash">blissify -g -d deviceCodename</code></pre>
258</doc-codeblock></div>
259<p><strong>Note:</strong> You can also use the legacy <code v-pre>blissify</code> command:</p>
260<div class="codeblock-wrapper"><doc-codeblock>
261<pre class="language-bash"><code v-pre class="language-bash">blissify deviceCodename</code></pre>
262</doc-codeblock></div>
263<doc-anchor-target id="after-building">
264 <h2>
265 <doc-anchor-trigger class="header-anchor-trigger" to="#after-building">#</doc-anchor-trigger>
266 <span>After Building</span>
267 </h2>
268</doc-anchor-target>
269<p>There are two possible outcomes after the build process:</p>
270<ul>
271<li><p>If the build fails, you will see a red error message from <code v-pre>make</code>. In this case, you need to fix the issue, which is often related to the device tree or configuration. If the problem persists, submit a bug report to the ROM developers, including the full build log and your device tree.</p>
272</li>
273<li><p>If the build succeeds, you will see the Bliss logo in ASCII. Congratulations! You have successfully built BlissRoms for your device. Proceed with the following steps:</p>
274</li>
275</ul>
276<ol>
277<li>Go to the artifacts directory for your device:</li>
278</ol>
279<div class="codeblock-wrapper"><doc-codeblock>
280<pre class="language-bash"><code v-pre class="language-bash">cd out/target/product/deviceCodename/</code></pre>
281</doc-codeblock></div>
282<ol start="2">
283<li>You will find a <code v-pre>.zip</code> file following the format <code v-pre>Bliss-vxx.xx-deviceCodename-UNOFFICIAL-vanilla-202xxxxx.zip</code>. Choose a custom recovery of your choice, flash it on your device, and install the built BlissRoms package.</li>
284</ol>
285<p>Bliss versions starting with 14.xx are based on Android 11, 15.xx on Android 12/12.1, and 16.xx on Android 13.</p>
286<doc-anchor-target id="report-build-issues">
287 <h2>
288 <doc-anchor-trigger class="header-anchor-trigger" to="#report-build-issues">#</doc-anchor-trigger>
289 <span>Report Build Issues</span>
290 </h2>
291</doc-anchor-target>
292<p>If you encounter any issues during the build process, you can reach out to us for support on <a href="https://t.me/Team_Bliss_Build_Support">Telegram (BlissRoms Build Support)</a>.</p>
293<p>Congratulations on successfully building BlissROMs! Enjoy flashing and using your custom ROM!</p>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]294
295
296 <!-- Required only on API pages -->
297 <doc-toolbar-member-filter-no-results />
298 </div>
299 <footer class="clear-both">
300 <div class="flex flex-wrap items-center justify-between mt-14">
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]301 <a class="my-2.5 inline-flex items-center text-sm whitespace-nowrap text-blue-500 dark:text-blue-400 hover:text-blue-700 hover:underline" href="https://github.com/BlissRoms/Documentation/blob/master/getting-started/build.md" target="_blank" rel="noopener">
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]302 <svg class="mr-1.5" xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="currentColor" overflow="visible"><path d="M20 12c-.55 0-1 .45-1 1v7c0 .55-.45 1-1 1H4c-.55 0-1-.45-1-1V6c0-.55.45-1 1-1h7c.55 0 1-.45 1-1s-.45-1-1-1H4C2.35 3 1 4.35 1 6v14c0 1.65 1.35 3 3 3h14c1.65 0 3-1.35 3-3v-7c0-.55-.45-1-1-1z" /><path d="M22.21 1.79c-1.18-1.18-3.24-1.18-4.41 0l-9.5 9.5c-.13.13-.22.29-.26.46l-1 4c-.08.34.01.7.26.95.18.2.44.3.7.3.08 0 .16-.01.24-.03l4-1c.18-.04.34-.13.46-.26l9.5-9.5c1.22-1.22 1.22-3.2.01-4.42zm-1.42 3l-9.3 9.3-2.11.53.53-2.11 9.3-9.3c.42-.42 1.16-.42 1.59 0 .43.43.43 1.15-.01 1.58z" /><path fill="none" d="M0 0h24v24H0z" /></svg>
303 <span>Edit on GitHub</span>
304 </a>
305 </div>
306
307 <nav class="flex mt-14">
308 <div class="w-1/2">
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]309 <a class="px-5 py-4 h-full flex items-center break-normal font-medium text-blue-500 dark:text-blue-400 border border-gray-300 hover:border-gray-400 dark:border-dark-650 dark:hover:border-dark-450 rounded-l-lg transition-colors duration-150 relative hover:z-5" href="../../getting-started/installations/">
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]310 <svg xmlns="http://www.w3.org/2000/svg" class="mr-3" width="24" height="24" viewBox="0 0 24 24" fill="currentColor" overflow="visible"><path d="M19 11H7.41l5.29-5.29a.996.996 0 10-1.41-1.41l-7 7a1 1 0 000 1.42l7 7a1.024 1.024 0 001.42-.01.996.996 0 000-1.41L7.41 13H19c.55 0 1-.45 1-1s-.45-1-1-1z" /><path fill="none" d="M0 0h24v24H0z" /></svg>
311 <span>
312 <span class="block text-xs font-normal text-gray-400 dark:text-dark-400">Previous</span>
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]313 <span class="block mt-1">Setting Up Environment</span>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]314 </span>
315 </a>
316 </div>
317
318 <div class="w-1/2">
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]319 <a class="px-5 py-4 -mx-px h-full flex items-center justify-end break-normal font-medium text-blue-500 dark:text-blue-400 border border-gray-300 hover:border-gray-400 dark:border-dark-650 dark:hover:border-dark-450 rounded-r-lg transition-colors duration-150 relative hover:z-5" href="../../getting-started/conclusion/">
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]320 <span>
321 <span class="block text-xs font-normal text-right text-gray-400 dark:text-dark-400">Next</span>
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]322 <span class="block mt-1">Conclusion</span>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]323 </span>
324 <svg xmlns="http://www.w3.org/2000/svg" class="ml-3" width="24" height="24" viewBox="0 0 24 24" fill="currentColor" overflow="visible"><path d="M19.92 12.38a1 1 0 00-.22-1.09l-7-7a.996.996 0 10-1.41 1.41l5.3 5.3H5c-.55 0-1 .45-1 1s.45 1 1 1h11.59l-5.29 5.29a.996.996 0 000 1.41c.19.2.44.3.7.3s.51-.1.71-.29l7-7c.09-.09.16-.21.21-.33z" /><path fill="none" d="M0 0h24v24H0z" /></svg>
325 </a>
326 </div>
327 </nav>
328 </footer>
329 </main>
330
331 <div class="border-t dark:border-dark-650 pt-6 mb-8">
332 <footer class="flex flex-wrap items-center justify-between">
333 <div>
334 <ul class="flex flex-wrap items-center text-sm">
Retype GitHub Actionf36abaf2022-06-21 10:39:33 +0000[diff] [blame]335 <li>
336 <a class="block mr-4 py-2 text-sm whitespace-nowrap transition-colors duration-200 ease-linear text-blue-500 dark:text-blue-400 hover:text-blue-800 dark:hover:text-blue-200 md:mb-0" href="https://blisslabs.org">A BlissLabs Project</a>
337 </li>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]338 </ul>
339 </div>
Retype GitHub Action7cb36032023-02-25 09:50:26 +0000[diff] [blame]340 <div class="docs-copyright py-2 text-gray-500 dark:text-dark-350 text-sm leading-relaxed"><p>© Copyright 2013-2023 – <a href="https://blisslabs.org">BlissLabs</a> – All rights reserved</p></div>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]341 </footer>
342 </div>
343 </div>
344
345 <!-- Rendered if sidebar right is enabled -->
346 <!-- Sidebar right skeleton-->
347 <div v-cloak class="fixed top-0 bottom-0 right-0 translate-x-full bg-white border-gray-200 lg:sticky lg:border-l lg:shrink-0 lg:pt-6 lg:transform-none sm:w-1/2 lg:w-64 lg:z-0 md:w-104 sidebar-right skeleton dark:bg-dark-850 dark:border-dark-650">
348 <div class="pl-5">
349 <div class="w-32 h-3 mb-4 bg-gray-200 dark:bg-dark-600 rounded-full loading"></div>
350 <div class="w-48 h-3 mb-4 bg-gray-200 dark:bg-dark-600 rounded-full loading"></div>
351 <div class="w-40 h-3 mb-4 bg-gray-200 dark:bg-dark-600 rounded-full loading"></div>
352 </div>
353 </div>
354
355 <!-- User should be able to hide sidebar right -->
356 <doc-sidebar-right v-cloak></doc-sidebar-right>
357 </div>
358
359 </div>
360 </div>
361
362 <doc-search-mobile></doc-search-mobile>
363 <doc-back-to-top></doc-back-to-top>
364 </div>
365
366
367 <div id="docs-overlay-target"></div>
368
Retype GitHub Action0951e032023-06-04 03:05:27 +0000[diff] [blame]369 <script>window.__DOCS__ = { "title": "Build Initialization", level: 2, icon: "file", hasPrism: true, hasMermaid: false, hasMath: false }</script>
Retype GitHub Action4a1e68c2022-06-21 05:48:08 +0000[diff] [blame]370</body>
371</html>