App icon

When you create your project using npx v7cli new, you're asked to specify the filename you wish to use for your app icon. This filename then points to a file relative to the src directory of your project. So, with the default, icon.png becomes ./src/icon.png. The wizard adds @local: to the filename to tell ArcOS that your app uses an icon that's on the filesystem instead of one of ArcOS' built-in icons.

When the project is created, place your image file in the src directory. Make sure the filename matches the one in _app.tpa exactly, including casing, even if your device runs Windows. This is because the ArcOS servers run on Linux, so ArcOS' filesystem is automatically case sensitive.

Caveats

• The current implementation isn't perfect. For one, the app icon doesn't show up while you're developing your app. This is because ArcOS only tries to locate on-filesystem app icons if the app is registered in ArcOS' AppStorage service, which has an internal appIconCache that caches app icon files of every registered app.

• Keep in mind that your app's icon is not the same as the icon you can specify for the App Store. To add assets to your app store page, please reference this page.