-
-
Notifications
You must be signed in to change notification settings - Fork 705
/
oem.php
102 lines (88 loc) · 6.74 KB
/
oem.php
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
<?php
require_once __DIR__.'/_backend/preload.php';
$page['title'] = 'Information for OEMs ⋅ elementary';
$page['styles'] = array(
'styles/oem.css'
);
include $template['header'];
include $template['alert'];
?>
<div class="grid">
<div class="two-thirds">
<h1>Information for OEMs</h1>
<h4>Give your customers the best experience with elementary OS.</h4>
</div>
</div>
<div class="grid">
<div class="two-thirds">
<h2>Partners & Retailers</h2>
<p>We offer two ways to be listed as an OEM of elementary OS in <a href="https://store.elementary.io">our store</a>, with differing requirements and benefits.</p>
</div>
<div class="half copy">
<h3>Partner</h3>
<p>Per-model approval, with each model featured in <a href="https://store.elementary.io">our store</a>.</p>
<p>Requirements:</p>
<ul>
<li>Official involvement from elementary, Inc.</li>
<li>Negotiable per-device royalty</li>
<li>Strict software guidelines</li>
<li><a href="<?php echo $page['lang-root'].'brand'; ?>">Trademark compliance</a></li>
</ul>
</div>
<div class="half copy">
<h3>Retailer</h3>
<p>A link to your website or landing page listed in <a href="https://store.elementary.io">our store</a>.</p>
<p>Requirements:</p>
<ul>
<li>Selling devices with elementary OS</li>
<li>Per-device royalty encouraged</li>
<li><a href="<?php echo $page['lang-root'].'brand'; ?>">Trademark compliance</a></li>
</ul>
</div>
</div>
<div class="grid">
<div class="two-thirds">
<h2>Resources</h2>
</div>
<div class="two-thirds copy">
<h3 id="installation">Installation</h3>
<p>The elementary OS Installer treats every installation as an OEM installation; step through it to install the OS, then shut down the device and it is ready to be shipped to a customer. Or, to create your own custom image: install the OS, configure any necessary packages or settings using a temporary administrator account, delete the account, and then create an image of the disk. In both cases, Initial Setup will create an end user account upon the customer's first boot.</p>
<p><a href="https://github.com/elementary/installer" target="_blank" rel="noopener" class="read-more">Installer</a>
<p><a href="https://github.com/elementary/initial-setup" target="_blank" rel="noopener" class="read-more">Initial Setup</a>
<h3 id="system-settings">System Settings</h3>
<p>System Settings offers several advantages to OEMs shipping elementary OS. From its pluggable architecture to easily-provided branding, System Settings was designed with OEMs in mind.</p>
<h4 id="plugs">Plugs</h4>
<p>System Settings (codenamed <a href="https://github.com/elementary/switchboard" target="_blank" rel="noopener">Switchboard</a>) uses a concept of “Plugs” to provide pluggable settings for various hardware and software concerns. For example, <a href="https://github.com/elementary/switchboard-plug-mouse-touchpad/" target="_blank" rel="noopener">Mouse & Touchpad settings</a> are provided by a plug.</p>
<img src="images/oem/switchboard.png" alt="Switchboard" />
<p>OEMs can develop and ship custom plugs if special or unique hardware in the machine requires configuration in addition to what is available by default in elementary OS; for example, special sensors or input methods not present in most hardware. If relevant to a broader set of users, contributing it upstream to the <a href="https://github.com/elementary?q=switchboard-plug" target="_blank" rel="noopener">existing plugs</a> is highly encouraged.</p>
<a href="https://valadoc.org/switchboard-2.0/Switchboard.Plug.html" target="_blank" rel="noopener" class="read-more">Documentation</a>
<h4 id="oem-info">OEM Info in About</h4>
<p>The <a href="https://github.com/elementary/switchboard-plug-about/" target="_blank" rel="noopener">About</a> plug displays system information to the user and provides several system-wide actions, such as restoring settings, reporting issues, and getting help. In addition to software information (like the OS version), it also provides a space for hardware information. By default, this is filled in with a generic image and the system’s hostname. However, OEMs can provide custom branded data for this section.</p>
<img src="images/oem/switchboard-about.png" alt="Switchboard About" />
<p>By providing an <code>oem.conf</code> file, OEMs can fill in the manufacturer name, product name, model number, and manufacturer URL. An image can also be provided which replaces the generic hardware icon.</p>
<a href="https://github.com/elementary/switchboard-plug-about/#oem-configuration" target="_blank" rel="noopener" class="read-more">Learn More</a>
<h3 id="third-party-repos">Third-Party Repositories</h3>
<p>It is highly discouraged to ship elementary OS with software repositories other than the defaults in elementary OS plus a single repository provided and controlled by the OEM. <strong>Third-party repos effectively give root access and the ability to overwrite any system packages to potentially untrusted third parties.</strong> Even if the party is trustworthy, an OEM’s customer’s security and privacy are now at stake if third parties are compromised, or they reuse their password on multiple services, etc.</p>
<p>Further, if a third-party repository ever becomes unmaintained or unpublished, <strong>it may prevent regular OS updates.</strong> This could hold back potentially serious security and stability fixes from reaching the OEM’s customers.</p>
</div>
</div>
<div class="grid">
<div class="third">
<h3>News & Announcements</h3>
<p>We publish frequent updates on development, major announcements, tips for developers, featured apps, and more on our blog.</p>
<a class="button" href="https://blog.elementary.io/" target="_blank" rel="noopener">Visit our Blog</a>
</div>
<div class="third">
<h3>Brand Resources</h3>
<p>View the elementary logos, brand usage guidelines, color palette, and community logo. Plus download the official high-resolution and vector elementary logo assets.</p>
<a class="button" href="brand">View Brand Resources</a>
</div>
<div class="third">
<h3>Get in Touch</h3>
<p>Talk directly with the team by sending an email to <a href="mailto:[email protected]">[email protected]</a>. Whether you’re an existing partner or want to explore offering elementary OS, we look forward to chatting.</p>
<a class="button" href="mailto:[email protected]">Send an Email</a>
</div>
</div>
<?php
include $template['footer'];
?>