tverona1
43 lines
1.7 KiB
Markdown
43 lines
1.7 KiB
Markdown
# Quest App Launcher
|
|
|
|
An app launcher for Quest implemented in Unity.
|
|
|
|
## Overriding app icons and names
|
|
For each installed app, we extract the default app name (PackageManager.getApplicationLabel()) and default app icon (PackageManager.getApplicationIcon()). Sometimes, however, these do not map to the actual app name and icon in the Oculus Store. In order to override this, do the following:
|
|
|
|
### Override app names
|
|
Create a file called **appnames.txt**. Add a line per app with comma-separated package-id and desired name. Example:
|
|
appnames.txt:
|
|
com.mycompany.myapp,My Application
|
|
com.othercompany.otherapp,Other application
|
|
|
|
Copy this file (appnames.txt) to the following location on your Quest: Android/data/aaa.QuestAppLauncher.App/files
|
|
|
|
### Override app icons
|
|
Create a jpg file per app with the package-id as the filename. Example:
|
|
com.mycompany.myapp.jpg
|
|
com.thirdcompany.yetanotherapp.jpg
|
|
|
|
Copy these files to the following location on your Quest: Android/data/aaa.QuestAppLauncher.App/files
|
|
|
|
## Configuration
|
|
The app can be customized by creating a **config.json** file and copying it to the following location on your Quest: Android/data/aaa.QuestAppLauncher.App/files.
|
|
|
|
The following options are supported:
|
|
### Setting Grid Size
|
|
The default grid size is 3x3 cells. The grid size can be customized by specifying grid rows and columns as in the following example:
|
|
|
|
```
|
|
{
|
|
"gridSize": {
|
|
"rows": 2,
|
|
"cols": 4
|
|
}
|
|
}
|
|
```
|
|
|
|
## Source structure:
|
|
- Assets/Scenes/QuestAppLauncher.unity: The main scene
|
|
- Assets/Plugins/Android: Android-specific implementation to retrieve installed apps etc, written in Java
|
|
- Assets/Scripts: Main set of C# scripts for grid population, scroll handling etc.
|