Skip to content

Commit

Permalink
Continue improving phrasing
Browse files Browse the repository at this point in the history
  • Loading branch information
GarboMuffin committed Jan 5, 2022
1 parent 1d97256 commit 3f805bd
Showing 1 changed file with 11 additions and 9 deletions.
20 changes: 11 additions & 9 deletions src/p4/PackagerOptions.svelte
Original file line number Diff line number Diff line change
Expand Up @@ -779,20 +779,21 @@
Unlike the other environments, Android support is not fully automated. You must manually create an app. This section will try to guide you through the process.
</div>

<p>This section assumes you have complete access to a Windows, macOS, or Linux computer.</p>
<p>This section assumes you have full access (including adminstrator/root) to a Windows, macOS, or Linux computer.</p>
<p>Parts of this section may be generated by various options selected above.</p>

<h3>Install Android Studio</h3>
<p><a href="https://developer.android.com/studio/">Install Android Studio.</a></p>
<p>This is quite large and may take a while.</p>

<h3>Create a new project</h3>
<p>Create a new project in Android studio.</p>
<p>Create a new project in Android Studio.</p>
<ul>
<li>Use the "Empty Activity" template</li>
<li>Set Name to your app's name, for example "<code>{$options.app.windowTitle}</code>"</li>
<li>Set Package name to "<code>org.turbowarp.packager.userland.{$options.app.packageName}</code>"</li>
<li>Choose a save location that you won't forget</li>
<li>Set Language to Kotlin</li>
<li>Set Language to "Kotlin"</li>
<li>Set Minimum SDK to "API 21: Android 5.0 (Lollipop)"</li>
</ul>

Expand Down Expand Up @@ -836,7 +837,8 @@
'}'
].join('\n')}
</pre>
<p>At this point, you now have a fully functional Android app. However, there are still a few more things you should change.</p>
<p>Make sure to leave the first line that says <code>package ...</code></p>
<p>At this point, you have a functional Android app. However, there are still a few more things you should change.</p>

<h3>Fixing screen orientation issues</h3>
<p>In the sidebar on the left, open app > main > AndroidManifest.xml</p>
Expand All @@ -860,7 +862,7 @@
</pre>

<h3>Updating colors</h3>
<p>If you ran the app now, it would have a purple color scheme, which may not be what you want. This can be changed.</p>
<p>Currently the app has a purple color scheme, which may not be what you want. This can be changed.</p>
<p>In the sidebar on the left, open app > main > res > values > color.xml.</p>
<p>You will see these lines:</p>
<pre>
Expand All @@ -870,7 +872,7 @@
' <color name="purple_700">#FF3700B3</color>',
].join('\n')}
</pre>
<p>Replace those lines with:</p>
<p>Replace those lines with: (the following snippet is generated according to your configured background color)</p>
<pre>
{[
` <color name="purple_200">#FF${$options.appearance.background.substr(1)}</color>`,
Expand All @@ -879,11 +881,11 @@
].join('\n')}
</pre>
<p>Do not change the other lines.</p>
<p>The above snippet will make the status bar match your app's background color. For advanced users, note that these color codes are a bit unusual in that the "alpha" or "transparency" byte goes first instead of last.</p>
<p>Ignore the bits about <code>purple_yyy</code> -- just them as is. While it would be a good idea to these colors, you will be making more work for yourself because you'll have to update some other files to reflect the new names.</p>
<p>For advanced users, note that these color codes are a bit unusual in that the "alpha" or "transparency" byte (typically <code>255</code> or <code>FF</code>) goes first instead of last.</p>
<p>Ignore the bits about <code>purple_yyy</code>; just them as is. It would typically be a good idea to rename these colors, but you will be making more work for yourself because you'll have to update some other files to reflect the new names.</p>

<h3>Updating the project</h3>
<p>It's likely that at some point you will want to update the project without redoing this entire guide. Updating is much simpler:</p>
<p>It's likely that at some point you will want to update the project without redoing this entire guide. Updating a project is much simpler:</p>
<ol>
<li>Open Android Studio and open the project</li>
<li>Delete everything inside the assets folder</li>
Expand Down

0 comments on commit 3f805bd

Please sign in to comment.