API d'icône d'app dynamique

Basculez entre différentes icônes d'app à l'exécution dans votre application WebView iOS, déclenché depuis votre application web.

Cette API permet aux utilisateurs de votre application de changer l'icône de l'application d'un simple clic. WebViewGold autorise jusqu'à trois icônes alternatives en plus de l'icône par défaut. Chaque fois que l'icône de l'application est modifiée dynamiquement, l'utilisateur sera notifié une fois l'opération réussie :

Si vous souhaitez changer l'icône de votre application au nom de vos utilisateurs, vous pouvez le faire en publiant une nouvelle version de votre application avec la nouvelle icône installée. Découvrez comment changer l'icône de votre application sur WebViewGold ici.

Pour changer dynamiquement l'icône de l'application, il suffit de créer un lien vers l'un des formats d'URL suivants :

<script>
// Passer à l'icône alternative 1
window.location.href = "changeicon://icon1"

// Passer à l'icône alternative 2
window.location.href = "changeicon://icon2"

// Passer à l'icône alternative 3
window.location.href = "changeicon://icon3"

// Revenir à l'icône par défaut
window.location.href = "changeicon://default"

</script>

Consultez une page de démonstration et de test de cette API ici.

Pour définir vos icônes alternatives, ouvrez les fichiers de votre application dans le Finder et accédez à WebView-Swift/WebView/ApplicationIcon/AppIconAlternate.
Dans ce dossier, vous verrez des icônes modèles pour toutes les tailles d'icônes requises sous iOS (iPhones et iPads), pour chaque icône alternative :

Les noms par défaut de chaque icône alternative sont : « AppIconAlternate1 », « AppIconAlternate2 » et « AppIconAlternate3 ».
Si vous le souhaitez, vous pouvez modifier les noms par défaut en éditant la variable alternativeAppIconNames dans le fichier Config :

Chaque icône (par exemple, « AppIconAlternateX ») nécessite cinq tailles différentes, décrites par le suffixe du nom de fichier :

Pour les iPhones :

AppIconAlternateX (60x60 pixels)
AppIconAlternateX@2x (120x120 pixels)
AppIconAlternateX@3x (180x180 pixels)

Pour les iPads :

AppIconAlternateX-ipad@2x (152x152 pixels)
AppIconAlternateX-ipad@3x (167x167 pixels)

Lorsque vous remplacez ces icônes modèles par les vôtres, assurez-vous qu'elles respectent le même format de nom de fichier (avec les suffixes indiqués ci-dessus) et la taille d'image correcte.

Consultez un guide plus détaillé sur les spécifications des icônes d'application ici.

Pour activer cette API (également pour la validation par l'App Store), veuillez ouvrir Info.plist en tant que code source (clic droit sur le fichier et sélectionnez « Open As » -> « Source Code » dans le menu contextuel) : Dans Info.plist, recherchez

<key>CFBundleIcons</key>
	<dict>
		<key>CFBundlePrimaryIcon</key>
		<dict>
			<key>CFBundleIconFiles</key>
			<array>
				<string></string>
			</array>
			<key>UIPrerenderedIcon</key>
			<false/>
		</dict>
	</dict>

et remplacez-le par

<key>CFBundleIcons</key>
<dict>
	<key>CFBundleAlternateIcons</key>
	<dict>
		<key>AppIconAlternate1</key>
		<dict>
			<key>CFBundleIconFiles</key>
			<array>
				<string>AppIconAlternate1</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<false/>
		</dict>
		<key>AppIconAlternate2</key>
		<dict>
			<key>CFBundleIconFiles</key>
			<array>
				<string>AppIconAlternate2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<false/>
		</dict>
		<key>AppIconAlternate3</key>
		<dict>
			<key>CFBundleIconFiles</key>
			<array>
				<string>AppIconAlternate3</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<false/>
		</dict>
	</dict>
	<key>CFBundlePrimaryIcon</key>
	<dict>
		<key>CFBundleIconFiles</key>
		<array>
			<string></string>
		</array>
		<key>UIPrerenderedIcon</key>
		<false/>
	</dict>
</dict>

De plus, recherchez

<key>CFBundleIcons~ipad</key>
<dict>
    <key>CFBundlePrimaryIcon</key>
    <dict>
        <key>CFBundleIconFiles</key>
        <array>
            <string></string>
        </array>
        <key>UIPrerenderedIcon</key>
        <false/>
    </dict>
</dict>

et remplacez-le par

<key>CFBundleIcons~ipad</key>
<dict>
	<key>CFBundleAlternateIcons</key>
	<dict>
		<key>AppIconAlternate1</key>
		<dict>
			<key>CFBundleIconFiles</key>
			<array>
				<string>AppIconAlternate1-ipad</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<false/>
		</dict>
		<key>AppIconAlternate2</key>
		<dict>
			<key>CFBundleIconFiles</key>
			<array>
				<string>AppIconAlternate2-ipad</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<false/>
		</dict>
		<key>AppIconAlternate3</key>
		<dict>
			<key>CFBundleIconFiles</key>
			<array>
				<string>AppIconAlternate3-ipad</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<false/>
		</dict>
	</dict>
	<key>CFBundlePrimaryIcon</key>
	<dict>
		<key>CFBundleIconFiles</key>
		<array>
			<string></string>
		</array>
		<key>UIPrerenderedIcon</key>
		<false/>
	</dict>
</dict>

Il s'agit du paramétrage par défaut concernant les noms des icônes alternatives et le nombre de fichiers d'icônes alternatives.

API d'icône d'app dynamique

Trop occupé ? Nous configurons votre app pour vous.

Compilez dans votre navigateur