Merge pull request #93 from kiwix/92-phet-custom-app

PhET custom app

Author: kelson42

README.md

@@ -53,6 +53,8 @@ These key / values can be, but do not need to be included in the `info.json` fil
 
 - `bundle_id` - (optional) It should match to the bundle id set on the Apple Developer website for this app. If it's not set it will default to: "org.kiwix.custom.{brand_name}", where the brand name is the name of the folder, eg: "org.kiwix.custom.dwds".
 
+- `disable_immersive_reading` - optional (true| false) - if set to true, it will disable the immersive reading functionality on iOS, which is hiding the top / bottom nav bars while scrolling the web content. If the ZIM content is specific to a full screen experience (eg: PhET) it might be better to turn this feature off, so that the user navigation is not blocked (eg navigating back, search, bookmarks ect).
+
 - `zim_auth` - (optional) this is needed if standard http authentication is required to download the ZIM file. This should be set to **an environment variable name**, which will be resolved during build time. Make sure that the environment variable itself is set up properly before running the build process. **Do not place any credentials directly here, it's not safe, and won't work.**
 
 ## XCAssets file

phet/info.json

@@ -0,0 +1,14 @@
+{
+    "about_app_url": "https://www.kiwix.org/support",
+    "about_text": "Chemistry & Physics simulation",
+    "app_name": "PhET",
+    "app_store_id": "id6744251352",
+    "bundle_id": "org.kiwix.phet",
+    "development_team": "L7HWM3SP3L",
+    "disable_immersive_reading": true,
+    "settings_default_external_link_to": "alwaysLoad",
+    "settings_show_external_link_option": true,
+    "settings_show_search_snippet": false,
+    "uses_audio": false,
+    "zim_url": "http://localhost:8000/phet_mul_all_2025-03.zim"
+}

phet/phet.xcassets/AppIcon.appiconset/Contents.json

@@ -0,0 +1,74 @@
+{
+  "images" : [
+    {
+      "filename" : "phet_logo_1024.png",
+      "idiom" : "universal",
+      "platform" : "ios",
+      "size" : "1024x1024"
+    },
+    {
+      "filename" : "phet_logo_16.png",
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "16x16"
+    },
+    {
+      "filename" : "phet_logo_32 1.png",
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "16x16"
+    },
+    {
+      "filename" : "phet_logo_32.png",
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "32x32"
+    },
+    {
+      "filename" : "phet_logo_64.png",
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "32x32"
+    },
+    {
+      "filename" : "phet_logo_128.png",
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "128x128"
+    },
+    {
+      "filename" : "phet_logo_256.png",
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "128x128"
+    },
+    {
+      "filename" : "phet_logo_256 1.png",
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "256x256"
+    },
+    {
+      "filename" : "phet_logo_512.png",
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "256x256"
+    },
+    {
+      "filename" : "phet_logo_512 1.png",
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "512x512"
+    },
+    {
+      "filename" : "phet_logo_1024 1.png",
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "512x512"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

phet/phet.xcassets/AppIcon.appiconset/phet_logo_1024 1.png

@@ -0,0 +1,6 @@
+{
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

phet/phet.xcassets/AppIcon.appiconset/phet_logo_1024.png

@@ -0,0 +1,12 @@
+{
+  "images" : [
+    {
+      "filename" : "icon_128x128.png",
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

phet/phet.xcassets/AppIcon.appiconset/phet_logo_128.png

@@ -0,0 +1,15 @@
+{
+  "images" : [
+    {
+      "filename" : "notebook.svg",
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  },
+  "properties" : {
+    "preserves-vector-representation" : true
+  }
+}

phet/phet.xcassets/AppIcon.appiconset/phet_logo_16.png

@@ -0,0 +1,12 @@
+{
+  "images" : [
+    {
+      "filename" : "BookmarkAdded.png",
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

phet/phet.xcassets/AppIcon.appiconset/phet_logo_256 1.png

@@ -0,0 +1,12 @@
+{
+  "images" : [
+    {
+      "filename" : "BookmarkRemoved.png",
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

phet/phet.xcassets/AppIcon.appiconset/phet_logo_256.png

@@ -0,0 +1,16 @@
+{
+  "images" : [
+    {
+      "filename" : "phet_welcomeLogo.svg",
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  },
+  "properties" : {
+    "preserves-vector-representation" : true,
+    "template-rendering-intent" : "original"
+  }
+}

phet/phet.xcassets/AppIcon.appiconset/phet_logo_32 1.png

@@ -25,6 +25,7 @@
     "about_text": "CUSTOM_ABOUT_TEXT",
     "settings_default_external_link_to": "SETTINGS_DEFAULT_EXTERNAL_LINK_TO",
     "settings_show_search_snippet": "SETTINGS_SHOW_SEARCH_SNIPPET",
+    "disable_immersive_reading": "DISABLE_IMMERSIVE_READING",
     "settings_show_external_link_option": "SETTINGS_SHOW_EXTERNAL_LINK_OPTION"
 }