|
779 | 779 | 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.
|
780 | 780 | </div>
|
781 | 781 |
|
782 |
| - <p>This section assumes you have complete access to a Windows, macOS, or Linux computer.</p> |
| 782 | + <p>This section assumes you have full access (including adminstrator/root) to a Windows, macOS, or Linux computer.</p> |
| 783 | + <p>Parts of this section may be generated by various options selected above.</p> |
783 | 784 |
|
784 | 785 | <h3>Install Android Studio</h3>
|
785 | 786 | <p><a href="https://developer.android.com/studio/">Install Android Studio.</a></p>
|
786 | 787 | <p>This is quite large and may take a while.</p>
|
787 | 788 |
|
788 | 789 | <h3>Create a new project</h3>
|
789 |
| - <p>Create a new project in Android studio.</p> |
| 790 | + <p>Create a new project in Android Studio.</p> |
790 | 791 | <ul>
|
791 | 792 | <li>Use the "Empty Activity" template</li>
|
792 | 793 | <li>Set Name to your app's name, for example "<code>{$options.app.windowTitle}</code>"</li>
|
793 | 794 | <li>Set Package name to "<code>org.turbowarp.packager.userland.{$options.app.packageName}</code>"</li>
|
794 | 795 | <li>Choose a save location that you won't forget</li>
|
795 |
| - <li>Set Language to Kotlin</li> |
| 796 | + <li>Set Language to "Kotlin"</li> |
796 | 797 | <li>Set Minimum SDK to "API 21: Android 5.0 (Lollipop)"</li>
|
797 | 798 | </ul>
|
798 | 799 |
|
|
836 | 837 | '}'
|
837 | 838 | ].join('\n')}
|
838 | 839 | </pre>
|
839 |
| - <p>At this point, you now have a fully functional Android app. However, there are still a few more things you should change.</p> |
| 840 | + <p>Make sure to leave the first line that says <code>package ...</code></p> |
| 841 | + <p>At this point, you have a functional Android app. However, there are still a few more things you should change.</p> |
840 | 842 |
|
841 | 843 | <h3>Fixing screen orientation issues</h3>
|
842 | 844 | <p>In the sidebar on the left, open app > main > AndroidManifest.xml</p>
|
|
860 | 862 | </pre>
|
861 | 863 |
|
862 | 864 | <h3>Updating colors</h3>
|
863 |
| - <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> |
| 865 | + <p>Currently the app has a purple color scheme, which may not be what you want. This can be changed.</p> |
864 | 866 | <p>In the sidebar on the left, open app > main > res > values > color.xml.</p>
|
865 | 867 | <p>You will see these lines:</p>
|
866 | 868 | <pre>
|
|
870 | 872 | ' <color name="purple_700">#FF3700B3</color>',
|
871 | 873 | ].join('\n')}
|
872 | 874 | </pre>
|
873 |
| - <p>Replace those lines with:</p> |
| 875 | + <p>Replace those lines with: (the following snippet is generated according to your configured background color)</p> |
874 | 876 | <pre>
|
875 | 877 | {[
|
876 | 878 | ` <color name="purple_200">#FF${$options.appearance.background.substr(1)}</color>`,
|
|
879 | 881 | ].join('\n')}
|
880 | 882 | </pre>
|
881 | 883 | <p>Do not change the other lines.</p>
|
882 |
| - <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> |
883 |
| - <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> |
| 884 | + <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> |
| 885 | + <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> |
884 | 886 |
|
885 | 887 | <h3>Updating the project</h3>
|
886 |
| - <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> |
| 888 | + <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> |
887 | 889 | <ol>
|
888 | 890 | <li>Open Android Studio and open the project</li>
|
889 | 891 | <li>Delete everything inside the assets folder</li>
|
|
0 commit comments