Skip to content
This repository has been archived by the owner on Feb 20, 2024. It is now read-only.

Déploiement | Application Lelivrescolaire.fr

Jump to bottom
Jonathan Banon edited this page Aug 31, 2020 · 3 revisions

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 :

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:

  1. dézipper les zips à combiner dans un même répertoire
  2. créer un nouveau ZIP en mode non comprimé (STORE)
    1. par exemple avec la commande zip de MacOS ou Linux, il faut utiliser l'option -0
    2. lancer la commande depuis le répertoire qui contient les zips extraits pour éviter les chemins d'accès parasites
    3. exemple de commande de compression: zip -0 meslivres.zip * qui génère un zip contenant tous le contenu du répertoire actuel
  3. 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) :

mycontent.zip
+-chapter1id
| +-media
| +-page1.json
| +-page2.json
+-chapter2id

J'utilise un logiciel pour installer les manuels numériques :

  1. Airwatch
  2. Kwartz
  3. SQOOL
  4. Jamf Pro / Casper Suite
  5. ZuluDesk
  6. MobileIron
  7. Cisco Meraki

J'installe moi-même les manuels numériques

  1. Installation manuelle
  2. Déployer l'application depuis un serveur local, un serveur distant (http://), un répertoire partagé sur le réseau (partage NFS, Samba, lecteur réseau)
  3. Déployer l'application en mode silencieux
  4. Déployer les manuels numériques (contenu) depuis un serveur local
  5. Installation depuis une carte SD ou stockage interne
  6. Lecture directe depuis carte SD ou stockage interne (dézippé)
  7. Lecture directe depuis sur carte SD ou stockage interne (zippé)
  8. Installation sur des ordinateurs en réseau
  9. Installation via FileSharing
  10. Installation via config file

Aller plus loin

  1. API complète de l'application (URL Scheme)

Airwatch [Workspace ONE]

Tutoriel vidéo iOS : https://www.youtube.com/watch?v=GJnnIwQ2fjA&list=PLrkh0FrxZNQ9ukAKfJDjhLfVetAuRFbiz&index=2

Android :

  1. Téléchargez le ZIP contenant les contenus des manuels à déployer

  2. Rendez-vous dans la console web AirWatch

  3. Dans l'onglet Applications et livres, choisir Affichage en liste et ajoutez l'application "Lelivrescolaire.fr" (comment récupérer l'application ?)

  4. Dans l'onglet Applications et livres, allez à l'onglet Web et cliquez Ajouter 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çant LICENSE par la license réelle et le paramètre path par l'emplacement du fichier zip des livres),
    • Activez Déploiement automatique et Ajouter à l'écran d'accueil

  5. Affecter les applications et sites web aux terminaux visés.

  6. Une fois l'installation terminée, sur chaque tablette ouvrir le raccourci pour terminer la configuration

Kwartz

  1. Créez un équipement pilote en installant sur une tablette l'application "Lelivrescolaire.fr" (comment récupérer l'application ?)

  2. S'assurer que cet équipement pilote est connecté à Kwartz

  3. Téléchargez le ZIP contenant les contenus des manuels à déployer

  4. Allez sur la console web de Kwartz

  5. Dans l'onglet Documents, choisir Raccourcis, saisir une URL simple et existante comme www.android.com puis Ajouter

  6. 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çant LICENSE par la licence réelle et le paramètre path par l'emplacement du fichier zip des livres),

  7. Dans l'onglet Profil, faire Nouveau profil et y ajouter le raccourci défini précédemment

  8. Envoyer le profil sur l'équipement pilote

  9. Dans l'onglet Équipements, sélectionner l'équipement pilote et faire Stocker la configuration, ce qui va envoyer les applications installées sur l'équipement pilote vers le serveur Kwartz

  10. Déployer la configuration sur toutes les tablettes depuis l'onglet Déploiement

  11. 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

  1. Cliquez sur Apps puis Ajoutez une app

  2. cherchez lelivrescolaire.fr puis cliquez sur Ajouter pour l'application Lelivrescolaire.fr

  3. Sélectionnez le groupe d'appareil auquel rattacher l'application

  4. Cliquez sur le bouton Réglages puis réglez sur Change to automatic installation

  5. 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 automatiquement

  6. Retournez sur la liste de vos applications sur ZuluDesk. Editez l'application Lelivrescolaire.fr.

  7. Cliquez sur Options avancées puis Appliquer la configuration gérée puis copiez-collez le texte suivant en remplaçant 1234 par le code licence que vous avez reçu :

<plist version="1.0">
<dict>
<key>code</key>
<string>1234</string>
</dict>
</plist>

  1. Lancer l’application. Grâce à la configuration, elle va se connecter automatiquement avec votre code licence. Vous devriez voir un message de confirmation

  2. 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://)

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

c:\> cd Téléchargements
c:\> Lelivrescolaire.fr.setup_64.exe /S

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

c:\> cd Téléchargements
c:\> Lelivrescolaire.fr.setup_64.exe /D=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

  1. Générez un fichier .ZIP avec les manuels qui vous intéressent en vous rendant ici

  2. Copiez le fichier .ZIP sur votre serveur local

  3. Installez l'application Lelivrescolaire.fr sur les ordinateurs que vous voulez déployer

  4. 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çant LICENSE par la licence réelle et le paramètre path par l'emplacement du fichier zip des livres sur votre serveur local)

  5. 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.

  1. Téléchargez le ZIP contenant les contenus des manuels à déployer

  2. S’il n’existe pas, créer le répertoire "Carte SD ou stockage interne" > Android > data > fr.lelivrescolaire.lycee > files

  3. Ajoutez le fichier ZIP dans ce dossier files

  4. Utilisez les commandes content-load et license-activate pour procéder à la copie du contenu sur l'appareil et activer la licence :

    lls://commands/license-activate/content-load?code=LICENSE&path=sdcard:///fr.lelivrescolaire.lycee/files/monzip.zip

    en remplaçant LICENSE par le code licence de l'établissement et le paramètre path par l'emplacement du fichier zip

  5. Vous 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.

  1. Téléchargez le ZIP contenant les contenus des manuels à déployer

  2. S'il n'existe pas, créer le répertoire "Carte SD ou stockage interne" > Android > data > fr.lelivrescolaire.lycee > files

  3. Dézipper le fichier ZIP fourni dans le répertoire files, ce qui doit donner une structure comme :

structure de fichiers

  1. 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.

  1. Téléchargez les ZIPs contenant les contenus des manuels à déployer

  2. S'il n'existe pas, créer le répertoire "Carte SD ou stockage interne" > Android > data > fr.lelivrescolaire.lycee > files

  3. Placer les fichiers zips de manuels (nommés comme 6067284.zip) sans les renommer, directement dans le répertoire files

  4. L'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 Documentsprésent sur les iPads.

  1. Téléchargez le ZIP contenant les contenus des manuels à déployer
  2. Chargez les ZIPs qui vous intéressent dans le dossier Documents
  3. 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 :

<plist version="1.0">
<dict>
<key>code</key>
<string>1234</string>
</dict>
</plist>

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 :

  1. Connecter l'utilisateur dont le nom d'utilisateur est test et le mot de passe pswd
  2. Ouvrir le manuel 847623278

Je peux exécuter la commande :

lls://commands/user-login/resource-open?username=test&password=pswd&bookId=847623278

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

  1. Charger des contenus de manuels
  2. Supprimer des contenus de manuels
  3. Remise à 0 (reset) de l'application
  4. Ouvrir un manuel, une page ou un document
  5. Activer une licence
  6. Désactiver une licence
  7. Connecter un utilisateur
  8. 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 :

mycontent.zip
+-chapter1id
| +-media
| +-page1.json
| +-page2.json
+-chapter2id

Fonctionnement :

  1. 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.
Exemple : lls://commands/content-load
  1. 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).
Exemple : lls://commands/content-load?bookIds=[6067403, 6067399]
  1. 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).
Exemple : 
 - path : file:///somewhere/in/device/content.zip
 - commande : lls://commands/content-load?path=file%3A%2F%2Fsomewhere%2Fin%2Fdevice%2Fcontent.zip

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 :

  1. L'application prend la liste des bookIds donnés en paramètre, et supprime tous les contenus liés à ces manuels.
Exemple : lls://commands/content-destroy?bookIds=[6067403, 6067399]

Commandes relatives au "reset" de l'application

Remise à 0 de l'application : lls://commands/reset

Paramètres : aucun paramètre

Fonctionnement :

  1. Supprime tous les contenus embarqués
  2. Supprimer toutes les licences enregistrées
  3. 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 à ouvrir
  • pageId | optional | <Int> : ID de la page à ouvrir
  • docId | optional | <Int> : ID du document à ouvrir

Fonctionnement :

  1. Si aucun paramètre n'est fourni, l'application se contente de se lancer
Exemple : lls://commands/resource-open
  1. Si bookId est renseigné, l'application s'ouvre sur le manuel correspondant
Exemple : lls://commands/resource-open?bookId=6067403
  1. Si pageId et bookId sont renseignés l'application s'ouvre sur la page correspondante
Exemple : lls://commands/resource-open?bookId=6067403&pageId=6826700
  1. Si docId, pageId et bookId sont renseignés, l'application accède au document docId 
Exemple : lls://commands/resource-open?bookId=6067403&pageId=6826700&docId=VNOf9t-vFoMr2mmtrFtTV

Commandes relatives aux licences établissement

Activer une licence : lls://commands/license-activate

Paramètres :

  • code | required | <String> : Code licence de l'établissement

Fonctionnement :

  1. Valide et ajoute la licence correspondant au code à l'application
  2. Montre une erreur dans le cas où le code n'est pas valide
Exemple : lls://commands/license-activate?code=MYCODE

Désactiver une licence : lls://commands/license-remove

Paramètres : aucun paramètre

Fonctionnement :

  1. 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'utilisateur
  • password | required | <String> : Nom d'utilisateur ou email de l'utilisateur
  • token | optional | <String> : Token JWT de l'utilisateur

Fonctionnement :

  1. Si token est renseigné, essaye d'authentifier l'utilisateur par token
Exemple : lls://commands/user-login?token=someusertoken
  1. Si username ET password sont renseignés, essaye d'authentifier l'utilisateur par le couple username / password 
Exemple : lls://commands/user-login?username=myUsername&password=myPaswd

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 :

  1. Déconnecte l'utilisateur courant
Clone this wiki locally