-
Notifications
You must be signed in to change notification settings - Fork 16
/
index.html
462 lines (461 loc) · 20.9 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
<!DOCTYPE html>
<!--
Fractal by HTML5 UP
html5up.net | @ajlkn
Free for personal and commercial use under the CCA 3.0 license (html5up.net/license)
-->
<html lang="en">
<head>
<meta name="generator" content="Bluefish 2.2.10" >
<title>LineageOS for microG</title>
<meta charset="utf-8">
<meta name="viewport" content=
"width=device-width, initial-scale=1">
<!--[if lte IE 8]><script src="assets/js/ie/html5shiv.js"></script><![endif]-->
<link rel="stylesheet" href="assets/css/main.css">
<link rel="stylesheet" href="assets/css/scroll-to-top.css">
<!--[if lte IE 8]><link rel="stylesheet" href="assets/css/ie8.css" /><![endif]-->
<!--[if lte IE 9]><link rel="stylesheet" href="assets/css/ie9.css" /><![endif]-->
<link rel="icon" type="image/png" href="/favicon-16x16.png"
sizes="16x16">
<link rel="icon" type="image/png" href="/favicon-32x32.png"
sizes="32x32">
<link rel="icon" type="image/png" href="/favicon-96x96.png"
sizes="96x96">
</head>
<body id="top">
<!-- Header -->
<header id="header">
<div class="content">
<h1><a href="#">LineageOS for microG</a></h1>
<p>The full Android experience<br>
without Google Apps</p>
<ul class="actions">
<p>
<li>
<a href="https://download.lineage.microg.org/" class=
"button special icon fa-download">Download</a>
</li>
<li>
<a href="https://liberapay.com/microG/" class=
"button icon scrolly">
<i class="fa fa-heart" aria-hidden="true" style="color:#EB1E63;padding-right:0.3em"></i>
Donate</a>
</li>
</p>
<p>
<li>
<a href="#instructions" class=
"button icon fa-chevron-down scrolly">Installation</a>
</li>
<li>
<a href="#faq" class=
"button icon fa-chevron-down scrolly">FAQ</a>
</li>
</p>
</ul>
</div>
<div class="image phone">
<div class="inner"><img src="images/screen_logo.jpg" alt=
""></div>
</div>
</header><!-- One -->
<section id="one" class="wrapper style2 special">
<header class="major">
<h2><a href="https://lineageos.org/">LineageOS</a> unofficial
fork with built-in<br>
<a href="https://microg.org/">microG</a> gapps
implementation</h2>
</header>
<ul class="icons major">
<li><span class="icon fa-refresh"><span class=
"label">Updates</span></span></li>
<li><span class="icon fa-cloud"><span class=
"label">GooglePlay</span></span></li>
<li><span class="icon fa-code"><span class=
"label">Open-source</span></span></li>
<li><span class="icon fa-desktop"><span class=
"label">GitHub</span></span></li>
</ul>
</section><!-- Two -->
<section id="two" class="wrapper">
<div class="inner alt">
<section class="spotlight">
<div class="image"><img src="images/screen01.jpg" alt=
""></div>
<div class="content">
<h3>Full Play Services compatibility</h3>
<p>Our ROM has built-in microG free-as-in-freedom
re-implementation of Google's proprietary Android user
space apps and libraries.<br>
This enables you to use every Google service you need
without keeping another closed-source binary blob in your
Android system.</p>
</div>
</section>
<section class="spotlight">
<div class="image"><img src="images/screen02.jpg" alt=
""></div>
<div class="content">
<h3>Native F-Droid support</h3>
<p>LineageOS for microG comes with F-Droid already
installed. You can use it to access plenty of FOSS
applications or even the Play Store via
<a href=
'https://gitlab.com/AuroraOSS/AuroraStore'>Aurora Store</a>.</p>
</div>
</section>
<section class="spotlight">
<div class="image"><img src="images/screen03.jpg" alt=
""></div>
<div class="content">
<h3>OTA updates</h3>
<p>We ship OTA updates from upstream LineageOS twice a month. In
this way you always receive new features and security
updates just few days after they are released
mainline.</p>
</div>
</section>
<section class="special">
<ul class="icons labeled">
<li><span class="icon fa-refresh"><span class=
"label">OTA updates twice a month</span></span></li>
<li><span class="icon fa-cloud"><span class=
"label">Compatible with Google Play
Services</span></span></li>
<li><span class="icon fa-code"><span class="label">Fully
open-source and free-software</span></span></li>
<li><span class="icon fa-desktop"><span class=
"label">Source code available on <a href=
"https://github.com/lineageos4microg">GitHub</a></span></span></li>
</ul>
</section>
</div>
</section><!-- Three -->
<section id="three" class="wrapper style2 special">
<ul class="actions">
<li>
<a href="https://download.lineage.microg.org/" class=
"button special icon fa-download">Download</a>
</li>
<li>
<a href="#faq" class=
"button icon fa-chevron-down scrolly">FAQ</a>
</li>
</ul>
</section><!-- Four -->
<section id="instructions" class="wrapper">
<div class="inner">
<header class="major">
<h2>Installation instructions</h2>
</header>
<section>
<p>This ROM has few changes from the official LineageOS
ROM, so you can follow the installation guide for your
device on the <a href=
"https://wiki.lineageos.org/install_guides.html">LineageOS
wiki</a>.</p>Before installing the ZIP you should check
that it has the correct signature. You have to use a Python
script to verify the signature, <a
href="https://github.com/lineageos4microg/update_verifier">
available here</a>.
Install <a href="https://www.python.org/downloads/">Python 3
</a> (if not already done) and the required packages (as
explained in the <a
href="https://github.com/lineageos4microg/update_verifier">
README</a>), then run:
<pre>
<code>python3 update_verifier.py lineageos4microg_pubkey lineage-microG.zip</code></pre>
</section>
<section>
<h3 id="migration">Migration from LineageOS</h3>
</section>
<section>
<h4>Clean install (wipe data and installed apps)</h4>
<p>If you don't care about losing your current data just
reboot into recovery, wipe System, Data, Cache and Dalvik
and, without rebooting, install LineageOS for microG.</p>
</section>
<section>
<h4>Dirty install (keep data and installed apps)</h4>
<p>Our ROM and LineageOS use different signing keys, so you
can't directely flash our ROM on top of the official LineageOS
while keeping your data; however, the procedure needed to
migrate from the official LineageOS is very simple.</p>
<p>Firstly, make sure the ZIP you want to install is newer
than the current installed ROM, if it is not, wait for the
next build.</p>
<p>If you have installed <b>unofficial</b> builds
of:</p>
<ul>
<li>F-Droid or F-Droid Privileged Extension</li>
<li>microG's apps (GmsCore, GsfProxy, FakeStore and
mapsv1 API)</li>
<li>MozillaNlpBackend</li>
<li>NominatimNlpBackend</li>
</ul>
<p>you have to uninstall them before the ROM migration. You
also have to uninstall the GApps if you have previously
installed them.</p>
<p>Then, depending on your recovery type, two methods
apply:</p>
<ul>
<li>Lineage recovery: Flash the LineageOS for microG ZIP
and confirm flash despite signature mismatch.</li>
<li>TWRP recovery: Download and flash <a href=
"https://download.lineage.microg.org/extra">the migration
ZIP</a> and, without rebooting, flash the LineageOS for
microG ZIP.</li>
</ul>
</section>
<section>
<h3>Upgrade</h3>
<p>To upgrade from one LineageOS for microG major version
(15.1, 16.0, 17.1 or 18.1) to another, follow the instrucions
for your device <a href="https://wiki.lineageos.org/upgrade_guides.html">here</a>.</p>
</section>
<header class="major">
<h2>Post-install</h2>
</header>
<section>
<p>First, open the "microG Settings" app and check if
everything is OK in the "Self-Check" section; you will
probably have to give microG some permissions, like
location and file access. The UnifiedNlp section will have
some issues: that's normal, we haven't configured it
yet.</p>
</section>
<section>
<h3>UnifiedNlp</h3>
<p>UnifiedNlp is the microG Network Location Provider,
which provides the current location of the device without
the use of the GPS. While Google's NLP can only use
Google's servers for positioning, UnifiedNlp obtains the
geolocation through different plugins, which interface to
different services.</p>
<p>By default there are two plugins installed:</p>
<ul>
<li>
<a href=
"https://f-droid.org/packages/org.microg.nlp.backend.ichnaea/">
MozillaNlpBackend</a>, which uses the <a href=
"https://location.services.mozilla.com/">Mozilla
Location Service</a> (online)
</li>
<li>
<a href=
"https://f-droid.org/packages/org.microg.nlp.backend.nominatim/">
NominatimNlpBackend</a>, which uses MapQuest's
Nominatim service (based on OpenStreetMap) for
geocoding (online)
</li>
</ul>
<p>If you want to use these plugins, go to microG Settings
-> UnifiedNlp Settings, configure and enable both.</p>
<p>If you instead want different plugins (like the <a href=
"https://f-droid.org/packages/org.fitchfamily.android.gsmlocation/">
LocalGsmNlpBackend</a>, which uses a local offline database
of the GSM towers to obtain the location) you can download
them in F-Droid and enable them in the same way.</p>
<p>Reboot and check whether UnifiedNlp is correctly set up
in the "Self-Check" section of the "microG Settings"
app.</p>
</section>
<section>
<h3>F-Droid</h3>
<p>You have the F-Droid Privileged Extension
installed by default, why not use it? To make a good use of
it go to the F-Droid Settings and enable auto updates.</p>
</section>
<section>
<h3>Google Cloud Messaging</h3>
<p>Many apps rely on the Google Cloud Messaging, a Google
proprietary system to push notifications to your device.
This feature is implemented in microG but, as not every
user requires it, is disabled by default. If you need it,
enable the "Google Device registration" and the "Google
Cloud Messaging" features in the "microG Settings" app.</p>
</section>
<section>
<h3>Weather service <i>Only up to LineageOS for microG 16.0</i></h3>
<p>If you want the weather features of LineageOS (like in
the lock screen or in the cLock widget) you have to
download a weather provider from <a href=
"https://download.lineageos.org/extras">here</a>. Choose
your favorite one, install it and configure it in cLock (or
in Settings → Apps → Gear icon → Weather).</p>
</section>
<section>
<h3>SU (root) <i>Only up to LineageOS for microG 16.0</i></h3>
<p>Our ROM doesn't include root by default for security
reasons, but you can easily install it: go <a href=
"https://download.lineageos.org/extras">here</a>, download
the appropriate ZIP and install it from the recovery.</p>
</section><!-- Five -->
</div>
</section>
<section id="five" class="wrapper style2 special">
<ul class="actions">
<li>
<a href="https://download.lineage.microg.org/" class=
"button special icon fa-download">Download</a>
</li>
</ul>
</section>
<section id="faq" class="wrapper">
<div class="inner">
<header class="major">
<h2>FAQ</h2>
</header>
<p id="faq1"><b>Why all of this? Isn't <a href=
"http://opengapps.org/">OpenGApps</a> free software?</b><br>
Yes and no, the name "OpenGApps" is misleading. While
OpenGApps <a href="https://github.com/opengapps">uses free
software to retrieve and bundle the GApps</a>, the apps
themselves are not free software, they are in fact the same
Google Apps you find on a new phone.</p>
<p id="faq2"><b>Why should I use microG instead of the
standard Google Play Services?</b><br>
First of all, freedom. I can't explain here why free software
is so important (this is a FAQ, not a 200 pages manual), but
if you're interested you can start by reading <a href=
"https://en.wikipedia.org/wiki/Free_software">this</a>.<br>
Second, the Play Services are very expensive in terms of
resources, they drain lots of battery and they use lots of
space, while microG requires much less resources. To give you
an idea, the smallest possible package of OpenGApps ("Pico
Package") on ARM 7.1 is ~125 MB, while the full microG suite
(GmsCore, GsfProxy, FakeStore, MozillaNlpBackend and
NominatimNlpBackend) is ~4 MB.</p>
<p id="faq3"><b>Isn't Android free software? Can't I just
install LineageOS without both GApps and microG?</b><br>
Android is based on the AOSP project, which is free software.
However many common features are handled by the proprietary
GApps, generally by the Google Play Services. You can use
LineageOS without GApps/microG, but you will probably miss
something. In particular, you won't have the:</p>
<ul>
<li>network localization services, which means that you can
only use the GPS for the positioning</li>
<li>Google Cloud Messaging, so you won't receive any push
notification for any app that relies on it</li>
<li>the Maps API, which means that any app that uses Google
Maps through the Maps API will probably crash</li>
</ul>
<p>With microG these services (and <a href=
"https://github.com/microg/android_packages_apps_GmsCore/wiki/Implementation-Status">
many others</a>) are reimplemented.</p>
<p id="faq4"><b>Is LineageOS for microG completely free
software?</b><br>
Unfortunately no, like LineageOS it still has some non-free
components. See the <a href=
"https://www.replicant.us">Replicant</a> project for more
information.</p>
<p id="faq5"><b>Which is the current status of microG? Which
APIs are already implemented?</b><br>
See <a href=
"https://github.com/microg/android_packages_apps_GmsCore/wiki/Implementation-Status">
here</a>.</p>
<p id="faq6"><b>Why do we need a custom build of LineageOS to
have microG? Can't I install microG on the official
LineageOS?</b><br>
MicroG requires a patch called "signature spoofing", which
allows the microG's apps to spoof themselves as Google Apps.
LineageOS' developers <a href=
"https://review.lineageos.org/#/c/64967/">refused</a>
(<a href=
"https://review.lineageos.org/#/c/65366/">multiple</a>
<a href="https://review.lineageos.org/#/c/195283/">times</a>)
to include the patch, forcing us to fork their project.</p>
<p id="faq7"><b>Wait, on their <a href=
"https://wiki.lineageos.org/faq.html#can-you-enable-signature-spoofing">
FAQ page</a> I see that they don't want to include the patch
for security reasons. Is this ROM unsafe?</b><br>
No. LineageOS' developers decided not to include this patch
for <a href=
"https://review.lineageos.org/#/c/195284/">various
reasons</a>.<br>
The signature spoofing could be an unsafe feature only if the
user blindly gives any permission to any app, as this
permission can't be obtained automatically by the apps.<br>
Moreover, to further strengthen the security of our ROM, we
modified the signature spoofing permission so that only
system privileged apps can obtain it, and no security threat
is posed to our users.</p>
<p id="faq8"><b>Do you use test keys?</b><br>
Heck, no! We sign all our builds with our own private
keys.</p>
<p id="faq9"><b>Do you offer OTA updates?</b><br>
Yes, twice a month.</p>
<p id="faq10"><b>Do you offer delta updates?</b><br>
Not currently, but it can be done if there's real demand.</p>
<p id="faq11"><b>Can I install apps from the Play Store on
this ROM?</b><br>
F-Droid is included in our ROM, so you can freely download
all the FOSS apps on their repositories.<br>
However, if you need apps which are available only on the
Play Store, you can use a Play Store client, like
<a href="https://f-droid.org/packages/com.aurora.store/">
Aurora Store</a>.</p>
<p id="faq12"><b>Do I have to enable "Unknown sources" to
install apps in F-Droid?</b><br>
Our ROM includes "F-Droid Privileged Extension", which allows
F-Droid to install and update apps without the need of user
interaction or the unsafe "Unknown sources" option.</p>
<p id="faq13"><b>Can you add support for my device? It is
officially supported by LineageOS</b><br>
We already build LineageOS for microG for every device
supported by LineageOS. Find your device in our <a href=
"https://download.lineage.microg.org/">Downloads
page</a>!</p>
<p id="faq14"><b>Can you add support for my device? It is not
supported by LineageOS though...</b><br>
No, I'm sorry.</p>
<p id="faq15"><b>I don't trust your build, I want to build it
myself!</b><br>
No problem! Our builds are done with <a href=
"https://github.com/lineageos4microg/docker-lineage-cicd">this
Docker image</a>, feel free to build it yourself.</p>
<p id="faq16"><b>I am running a custom build of LineageOS,
but yours is way cooler! How can I migrate to it without
losing my data?</b><br>
Replace the LineageOS official keys in our <a href=
"https://download.lineage.microg.org/extra">migration ZIP</a>
with your keys (or follow the suggestions in the <a href=
"https://wiki.lineageos.org/signing_builds.html#using-a-script">
LineageOS migration guide</a>).</p>
</div>
</section><a href='#' class='scroll-to-top'></a> <!-- Footer -->
<section id="bugreporting" class="wrapper">
<div class="inner">
<header class="major">
<h2>Where do I report a bug?</h2>
</header>
<div class="inner"><img src="images/bug_reporting.svg" alt=""
width="100%"></div>
</div>
</section><a href='#' class='scroll-to-top'></a> <!-- Footer -->
<footer id="footer">
<p class="copyright">© LineageOS for microG. Website credits:
<a href="https://html5up.net">HTML5 UP</a></p>
</footer><!-- Scripts -->
<script src="assets/js/jquery.min.js">
</script>
<script src="assets/js/jquery.scrolly.min.js">
</script>
<script src="assets/js/skel.min.js">
</script>
<script src="assets/js/util.js">
</script>
<!--[if lte IE 8]><script src="assets/js/ie/respond.min.js"></script><![endif]-->
<script src="assets/js/main.js">
</script>
<script src="assets/js/scroll-to-top.js">
</script> <!-- Scroll-to-top license:
Copyright (c) 2017 by Aleksandar Čugurović (https://codepen.io/choogoor/pen/dGpOoW)
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-->
</body>
</html>