{$_('options.otherEnvironmentsHelp')}
@@ -843,6 +851,126 @@NW.js support is deprecated and may be removed in the future. Use Electron instead if possible.
For further help and steps, see NW.js Documentation.
{/if} + {:else if $options.target === 'android'} +This section assumes you have full access (including adminstrator/root) to a Windows, macOS, or Linux computer.
+Parts of this section may be generated by various options selected above.
+ +This is quite large and may take a while.
+ +Create a new project in Android Studio.
+{$options.app.windowTitle}"org.turbowarp.packager.userland.{$options.app.packageName}"In the sidebar on the left, right click on "app", then select "New" > "Folder" > "Assets folder". Use the default settings.
+ ++ +
+Extract the zip and drag its files into "assets" folder you created. (You can directly drag and drop files over the assets folder in Android Studio)
+ +In the sidebar on the left, navigate to app > src > main > MainActivity. This will open a short Kotlin file.
+Replace everything after line 2 with the following:
+
+ {[
+ 'import android.annotation.SuppressLint',
+ 'import androidx.appcompat.app.AppCompatActivity',
+ 'import android.os.Bundle',
+ 'import android.webkit.WebView',
+ '',
+ 'class MainActivity : AppCompatActivity() {',
+ ' private lateinit var web: WebView',
+ '',
+ ' @SuppressLint("SetJavaScriptEnabled")',
+ ' override fun onCreate(savedInstanceState: Bundle?) {',
+ ' super.onCreate(savedInstanceState)',
+ ' web = WebView(this)',
+ ' web.settings.javaScriptEnabled = true',
+ ' web.loadUrl("file:///android_asset/index.html")',
+ ' setContentView(web)',
+ ' actionBar?.hide()',
+ ' supportActionBar?.hide()',
+ ' }',
+ '',
+ ' override fun onDestroy() {',
+ ' super.onDestroy()',
+ ' web.destroy()',
+ ' }',
+ '}'
+ ].join('\n')}
+
+ Make sure to leave the first line that says package ...
At this point, you have a functional Android app. However, there are still a few more things you should change.
+ +In the sidebar on the left, open app > main > AndroidManifest.xml
+Find the section that looks like this:
+
+ {[
+ ' ',
+ ].join('\n')}
+
+ And replace it with this:
+
+ {[
+ ' ',
+ ].join('\n')}
+
+
+ Currently the app has a purple color scheme, which may not be what you want. This can be changed.
+In the sidebar on the left, open app > main > res > values > color.xml.
+You will see these lines:
+
+ {[
+ ' #FFBB86FC ',
+ ' #FF6200EE ',
+ ' #FF3700B3 ',
+ ].join('\n')}
+
+ Replace those lines with: (the following snippet is generated according to your configured background color)
+
+ {[
+ ` #FF${$options.appearance.background.substr(1)} `,
+ ` #FF${$options.appearance.background.substr(1)} `,
+ ` #FF${$options.appearance.background.substr(1)} `,
+ ].join('\n')}
+
+ Do not change the other lines.
+For advanced users, note that these color codes are a bit unusual in that the "alpha" or "transparency" byte (typically 255 or FF) goes first instead of last.
Ignore the bits about purple_yyy; just leave 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.
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:
+