Déploiement | Applications Lelivrescolaire.fr
Avant toute chose...
1. Téléchargez l'application
Quel que soit votre méthode d'installation, vous aurez besoin d'installer l'application "Lelivrescolaire.fr". Vous trouverez ci-dessous les liens de téléchargement correspond aux différentes plateformes :
Windows 7-8-10 64 bits : https://ci.lls.fr/build/latest/win/Lelivrescolaire.fr.setup_64.exe
Windows 7-8-10 32 bits : https://ci.lls.fr/build/latest/win/Lelivrescolaire.fr.setup_32.exe
MacOS 10.10+ 64 bits : https://ci.lls.fr/build/latest/mac/Lelivrescolaire.fr.dmg
Linux 64 bits (Ubuntu 12.04+, Debian 8+) :
2. Récupérez les contenus (optionnel)
Si vous prévoyez de ne pas télécharger le contenu sur chaque appareil manuellement, vous allez avoir besoin de récupérer les contenus à déployer sous forme de fichier .ZIP
.
Des ZIPs pré-générés sont disponibles ici
Ces zips peuvent être utilisés tel quels, ou combinés en zips multi-manuels:
dézipper les zips à combiner dans un même répertoire
créer un nouveau ZIP en mode non comprimé (
STORE
)par exemple avec la commande
zip
de MacOS ou Linux, il faut utiliser l'option-0
lancer la commande depuis le répertoire qui contient les zips extraits pour éviter les chemins d'accès parasites
exemple de commande de compression:
zip -0 meslivres.zip *
qui génère un zip contenant tous le contenu du répertoire actuel
les utilitaires de zip ajoutent souvent des fichiers inutiles et potentiellement gênants aux archives qu'ils créent, les éviter
Le zip doit contenir les chapitres sous la forme suivante (il est normal que les chapitres de différents livres soient mélangés) :
J'utilise un logiciel pour installer les manuels numériques :
J'installe moi-même les manuels numériques
Aller plus loin
Airwatch [Workspace ONE]
Tutoriel vidéo iOS : https://www.youtube.com/watch?v=GJnnIwQ2fjA&list=PLrkh0FrxZNQ9ukAKfJDjhLfVetAuRFbiz&index=2
Android :
Rendez-vous dans la console web AirWatch
Dans l'onglet Applications et livres, choisir Affichage en liste et ajoutez l'application "Lelivrescolaire.fr" (comment récupérer l'application ?)
Dans l'onglet
Applications et livres
, allez à l'ongletWeb
et cliquezAjouter application
avec les paramètres suivants:Plateforme:
Android
,URL :
lls://commands/license-activate/content-load/?path=file:///storage/sdcard1/all.zip&code=LICENSE
(en remplaçantLICENSE
par la license réelle et le paramètrepath
par l'emplacement du fichier zip des livres),Activez
Déploiement automatique
etAjouter à l'écran d'accueil
Affecter les applications et sites web aux terminaux visés.
Une fois l'installation terminée, sur chaque tablette ouvrir le raccourci pour terminer la configuration
Kwartz
Créez un équipement pilote en installant sur une tablette l'application "Lelivrescolaire.fr" (comment récupérer l'application ?)
S'assurer que cet équipement pilote est connecté à Kwartz
Allez sur la console web de Kwartz
Dans l'onglet
Documents
, choisirRaccourcis
, saisir une URL simple et existante comme www.android.com puisAjouter
Cliquer sur l'URL pour l'éditer et changer l'adresse en
lls://commands/license-activate/content-load/?path=file:///storage/sdcard1/all.zip&code=LICENSE
(en remplaçantLICENSE
par la licence réelle et le paramètrepath
par l'emplacement du fichier zip des livres),Dans l'onglet
Profil
, faireNouveau profil
et y ajouter le raccourci défini précédemmentEnvoyer le profil sur l'équipement pilote
Dans l'onglet
Équipements
, sélectionner l'équipement pilote et faireStocker la configuration
, ce qui va envoyer les applications installées sur l'équipement pilote vers le serveur KwartzDéployer la configuration sur toutes les tablettes depuis l'onglet
Déploiement
Sur chaque tablette ouvrir le raccourci pour terminer la configuration
SQOOL
@REFAIRE AVEC LA LOGIQUE 1 APPLICATION
Jamf Pro / Casper Suite
Tutoriel vidéo : https://www.youtube.com/watch?v=Y14999-UPL0&list=PLrkh0FrxZNQ9xR61ddd0A9kL8K6yt4a7v&index=1
ZuluDesk
Cliquez sur
Apps
puisAjoutez une app
cherchez
lelivrescolaire.fr
puis cliquez surAjouter
pour l'applicationLelivrescolaire.fr
Sélectionnez le groupe d'appareil auquel rattacher l'application
Cliquez sur le bouton
Réglages
puis réglez surChange to automatic installation
Si vous n’êtes pas en « Volume Program Purchase » , un message va apparaitre sur les tablette pour valider l’installation de l’application.
Validez
et l’application s’installera automatiquementRetournez sur la liste de vos applications sur ZuluDesk. Editez l'application Lelivrescolaire.fr.
Cliquez sur
Options avancées
puisAppliquer la configuration gérée
puis copiez-collez le texte suivant en remplaçant1234
par le code licence que vous avez reçu :
Lancer l’application. Grâce à la configuration, elle va se connecter automatiquement avec votre code licence. Vous devriez voir un message de confirmation
Une fois que vous avez lancé l’application sur tous les iPads, vous pouvez supprimer la configuration dans Zuludesk car celle-ci n’est plus utile. Pour cela, retourner dans l’édition de l’application, décochez la case
Application la configuration Gérée
et enregistrez vos modifications. Rassurez-vous, la licence sera toujours enregistrée sur les iPads.
[@TODO : comment gérer le déploiement de contenu ?]
MobileIron
Lien vers la documentation MobileIron
Cette documentation est spécifique aux applications de collège, mais les manipulations à effectuer sont les mêmes avec l'application Lelivrescolaire.fr
Tutoriel vidéo iOS : https://www.youtube.com/watch?v=nRU2Y32L_s0&list=PLrkh0FrxZNQ9ukAKfJDjhLfVetAuRFbiz&index=3
Cisco Meraki
Lien vers la documentation Cisco Meraki
Cette documentation est spécifique aux applications de collège, mais les manipulations à effectuer sont les mêmes avec l'application Lelivrescolaire.fr
Tutoriel vidéo - iOS : https://www.youtube.com/watch?v=5rAsP0CdMJ0&list=PLrkh0FrxZNQ9ukAKfJDjhLfVetAuRFbiz&index=1
Installation manuelle
[@TODO]
Installation depuis un serveur local (http://), un serveur distant (http://) ou un emplacement fichier (file://)
Disponibilité : Windows, Linux, MacOS
Depuis un serveur local ou distant (http://)
Etape 1: Télécharger l’application via https://www.lelivrescolaire.fr/applications
Etape 2: Copier l’exécutable dans un répertoire accessible sur le serveur Web local ou distant
Exemple: http://le-serveur-web-de-mon-lycee.net/applications-lycee/
L’URL de l’application Windows 64bits sera: http://le-serveur-web-de-mon-lycee.net/applications-lycee/Lelivrescolaire.fr.setup_64.exe
Etape 3: Ouvrez une session sur un poste (PC Windows) sur lequel vous souhaitez installer l’application Lelivrescolaire.fr
Lancer votre navigateur et entrez l’URL: http://le-serveur-web-de-mon-lycee.net/applications-lycee/Lelivrescolaire.fr.setup_64.exe
Etape 4: Vous pouvez maintenant télécharger et installer l’application sans passer par votre connexion internet !
Depuis un répertoire partagé sur le réseau (partage NFS, Samba, lecteur réseau)
Etape 1: Télécharger l’application via https://www.lelivrescolaire.fr/applications
Etape 2: Copier l’exécutable dans le répertoire partagé de votre établissement
Exemple: F:\repertoire_partage\applications\Lelivrescolaire.fr.setup_64.exe
Etape 3:
Ouvrez une session sur un poste (PC Windows) sur lequel vous souhaitez installer l’application Lelivrescolaire.fr
Lancer « Explorateur de fichiers »
Ouvrez le répertoire partagé
Lancer l'installation
Etape 4: Vous pouvez maintenant installer l’application sans passer par votre connexion internet !
Installation de l’application en mode silencieux
Disponibilité : Windows
Ouvrez un « invite de commande » (cmd.exe)
Déplacer vous dans le dossier contenant l’application
Saisissez le nom de l’application suivi de
/S
Exemple
Installation de l'application pour Windows 64bits en mode silencieux
Installation de l’application en changeant le répertoire de destination
Disponibilité : Windows
Supposons que vous avez téléchargé l’application dans le lecteur C et dans le dossier « Téléchargements »
Supposons que vous souhaitez installer l’application dans le lecteur F et dans le dossier « applications_lycee »
Ouvrez un « invite de commande » (cmd.exe)
Déplacer vous dans le dossier contenant l’application
Saisissez le nom de l’application suivi de /D=F:\applications_lycee
Exemple
Installation de l'application pour Windows 64bits dans le dossier F:\applications_lycee
⚠️ Attention: Le dossier de l’application ne doit pas contenir d’espace
Installation des contenus des manuels numériques depuis un serveur local
Disponibilité : Windows, Android
Générez un fichier .ZIP avec les manuels qui vous intéressent en vous rendant ici
Copiez le fichier .ZIP sur votre serveur local
Installez l'application Lelivrescolaire.fr sur les ordinateurs que vous voulez déployer
Créez et copiez un webclip (raccourci web) sur ces ordinateurs. Le lien de ce webclip doit être
lls://commands/license-activate/content-load/?path=http://192.168.1.78/mesmanuels/lelivrescolaire.zip&code=LICENSE
(en remplaçantLICENSE
par la licence réelle et le paramètrepath
par l'emplacement du fichier zip des livres sur votre serveur local)Une fois l'installation terminée, sur chaque ordinateur ouvrir le raccourci pour terminer la configuration
Installation depuis une carte SD ou stockage interne vers une tablette Android
Disponibilité : Android
Étapes à réaliser pour installer les contenus sur les tablettes, depuis une carte SD ou depuis le stockage interne de celles ci . Ce mode permet aux utilisateurs de supprimer les données de livres depuis l'application.
S’il n’existe pas, créer le répertoire
"Carte SD ou stockage interne" > Android > data > fr.lelivrescolaire.lycee > files
Ajoutez le fichier ZIP dans ce dossier files
Utilisez les commandes
content-load
etlicense-activate
pour procéder à la copie du contenu sur l'appareil et activer la licence :en remplaçant
LICENSE
par le code licence de l'établissement et le paramètrepath
par l'emplacement du fichier zipVous devriez avoir un message de confirmation d'installation / activation
Vous pouvez également ajouter le paramètre ?storage_location=external
si vous souhaitez installer le contenu sur une carte SD amovible plûtot que dans le stockage interne de la tablette.
Lecture directe depuis carte SD ou stockage interne (dézippé)
Disponibilité : Android
Étapes à réaliser pour permettre la lecture sur carte SD. Ce mode permet d'utiliser un zip multi-livres. L'utilisateur ne pourra pas supprimer les données des manuels depuis l'application.
S'il n'existe pas, créer le répertoire
"Carte SD ou stockage interne" > Android > data > fr.lelivrescolaire.lycee > files
Dézipper le fichier ZIP fourni dans le répertoire files, ce qui doit donner une structure comme :
L'application va alors lire directement les contenus sur la carte SD ou stockage interne !
Lecture directe depuis carte SD ou stockage interne (zippé)
Disponibilité : Android
Étapes à réaliser pour permettre la lecture sur carte SD ou le stockage interne. Ce mode permet d'utiliser plusieurs zips de livres. L'utilisateur ne pourra pas supprimer les données des manuels depuis l'application.
S'il n'existe pas, créer le répertoire
"Carte SD ou stockage interne" > Android > data > fr.lelivrescolaire.lycee > files
Placer les fichiers zips de manuels (nommés comme
6067284.zip
) sans les renommer, directement dans le répertoire filesL'application va alors lire directement les contenus sur la carte SD ou le stockage interne !
Installation sur des ordinateurs en réseau
Disponibilité : Windows, Linux, MacOS
[@TODO]
Installation via FileSharing
Disponibilité : iOS
Tutoriel vidéo :
Cette méthode permet de charger les contenus en utilisant le répertoire Documents
présent sur les iPads.
Chargez les ZIPs qui vous intéressent dans le dossier
Documents
Lancez l'application, qui va alors détecter la présence des ZIPs et lancer l'installation des contenus
Activation via fichier de config
Disponibilité : iOS
Tutoriel vidéo : https://www.youtube.com/watch?v=BZYc3xgVIuw&list=PLrkh0FrxZNQ9ukAKfJDjhLfVetAuRFbiz&index=5&t=0s
Cette méthode ne permet pas de télécharger les contenus pour en disposer hors-connexion, mais permet d'activer les applications à partir du code licence de l'établissement, afin de permettre l'accès au contenu complet pour les utilisateur.
Que ce soit via le MDM natif d'Apple ou d'autres MDM type ZuluDesk, plusieurs systèmes donnent la possibilité d'appliquer une configuration à des flottes d'iPad dans un format plist
.
Pour activer des iPad par cette méthode, copiez-collez le texte suivant en remplaçant 1234
par le code licence que vous avez reçu :
API de l'application (URL Scheme)
Les applications Lelivrescolaire.fr offrent plusieurs commandes "URL Scheme" sous le format lls://commands/[command_name]
. Certaines commandes nécessitent des paramètres. Le format est alors : lls://commands/[command_name]?[paramètres]
.
Exemple : lls://commands/license-activate?code=1234
Pour Android, notez que le préfixe https://mdm.lls.fr/
marche également. Cela donne, par exemple, https://mdm.lls.fr/license-activate?code=1234
Chainage des commandes
Il est possible de chainer des commandes pour les exécuter dans un certain ordre.
Si je souhaite :
Connecter l'utilisateur dont le nom d'utilisateur est
test
et le mot de passepswd
Ouvrir le manuel
847623278
Je peux exécuter la commande :
Format de paramètres
les valeurs numériques et strings sont passées telles quelles (
bookId=123
,username=agnan
)les listes sont passées avec une syntaxe de tableaux JSON (
bookIds=[1,3,5]
)
Liste des commandes disponibles
Charger des contenus de manuels
Supprimer des contenus de manuels
Remise à 0 (reset) de l'application
Ouvrir un manuel, une page ou un document
Activer une licence
Désactiver une licence
Connecter un utilisateur
Déconnecter un utilisateur
Commandes relatives au contenu
Charger du contenu : lls://commands/content-load
Paramètres :
bookIds
| optional | Array<Int> : liste des IDs des manuels à télécharger dans le cas d'un chargement souhaité en mode "online"path
| optional | String : lien vers un ZIP de contenu à traiter par l'application. Tous les schémas d'URLs sont à priori disponibles :http(s)://
,file:///
,sdcard:///
.storage_location
| optional |"internal"|"external"
: (Android uniquement) permet de demander à l'application de télécharger le contenu plutôt vers le stockage "interne" (c'est le cas en l'absence du paramètre), soit le stockage "externe" (carte SD amovible).
Le zip doit contenir les chapitres sous la forme :
Fonctionnement :
Si aucun paramètre n'est renseigné, l'application va lire la licence courante et télécharger tous les manuels de cette licence. Si aucune licence n'est disponible, la commande indique qu'elle ne peut pas être exécutée.
Si le paramètre
bookIds
est renseigné, l'application va télécharger tous les contenus correspondant à ces manuels (sans tenir compte de la licence).
Si le paramètre
path
est renseigné, l'application va récupérer le fichier.zip
et le traiter pour intégrer les contenus (sans tenir compte de la licence).
Supprimer du contenu : lls://commands/content-destroy
Paramètres :
bookIds
| required | Array<Int> : liste des IDs des manuels à télécharger dans le cas d'un chargement souhaité en mode "online"
Fonctionnement :
L'application prend la liste des
bookIds
donnés en paramètre, et supprime tous les contenus liés à ces manuels.
Commandes relatives au "reset" de l'application
Remise à 0 de l'application : lls://commands/reset
Paramètres : aucun paramètre
Fonctionnement :
Supprime tous les contenus embarqués
Supprimer toutes les licences enregistrées
Supprimer tous les profils utilisateurs renseignés
Commandes relatives aux accès internes à l'application
Ouvrir une ressource : lls://commands/resource-open
Paramètres :
bookId
| optional | <Int> : ID du manuel à ouvrirpageId
| optional | <Int> : ID de la page à ouvrirdocId
| optional | <Int> : ID du document à ouvrir
Fonctionnement :
Si aucun paramètre n'est fourni, l'application se contente de se lancer
Si
bookId
est renseigné, l'application s'ouvre sur le manuel correspondant
Si
pageId
etbookId
sont renseignés l'application s'ouvre sur la page correspondante
Si
docId
,pageId
etbookId
sont renseignés, l'application accède au documentdocId
Commandes relatives aux licences établissement
Activer une licence : lls://commands/license-activate
Paramètres :
code
| required | <String> : Code licence de l'établissement
Fonctionnement :
Valide et ajoute la licence correspondant au
code
à l'applicationMontre une erreur dans le cas où le
code
n'est pas valide
Désactiver une licence : lls://commands/license-remove
Paramètres : aucun paramètre
Fonctionnement :
Supprimer la licence de l'application si il en existe une en place
Commandes relatives aux utilisateurs
Connecter un utilisateur : lls://commands/user-login
Paramètres :
username
| required | <String> : Nom d'utilisateur ou email de l'utilisateurpassword
| required | <String> : Nom d'utilisateur ou email de l'utilisateurtoken
| optional | <String> : Token JWT de l'utilisateur
Fonctionnement :
Si
token
est renseigné, essaye d'authentifier l'utilisateur par token
Si
username
ETpassword
sont renseignés, essaye d'authentifier l'utilisateur par le coupleusername
/password
A noter : le username et le password demandé correspondent à des comptes Lelivrescolaire.fr Utiliser des identifiants ENTs - par exemple - ne fonctionne pas.
Déconnecter un utilisateur : lls://commands/user-logout
Paramètres : aucun paramètre
Fonctionnement :
Déconnecte l'utilisateur courant
Last updated