Premiers pas avec le cadre de jeu

Démarrer avec Play 2.4.x/2.5.x - Windows, Java

Installations

Télécharger et installer:

  1. Java 8 - téléchargez l’installation appropriée à partir du site Oracle.

  2. Activator - téléchargez le zip depuis www.playframework.com/download et extrayez les fichiers dans le dossier Play cible, par exemple pour :

    c:\Play-2.4.2\activator-dist-1.3.5
    
  3. sbt - télécharger depuis www.scala-sbt.org.

Définissez les variables d’environnement :

  1. JAVA_HOME, par exemple :

    c:\Program Files\Java\jdk1.8.0_45
    

2. PLAY_HOME, par exemple :

   c:\Play-2.4.2\activator-dist-1.3.5;

3. SBT_HOME par exemple :

   c:\Program Files (x86)\sbt\bin;  

Ajoutez le chemin aux trois programmes installés aux variables de chemin :

 %JAVA_HOME%\bin;%PLAY_HOME%;%SBT_HOME%;

Correction de l’installation de Play 2.5

L’installation de Play 2.5.3 (la dernière version stable 2.5) s’accompagne d’un problème mineur. Réparer:

  1. Modifiez le fichier activator-dist-1.3.10\bin\activator.bat et ajoutez le caractère “%” à ​​la fin de la ligne 55. La ligne appropriée devrait ressembler à ceci : définir SBT_HOME=%BIN_DIRECTORY%
  2. Créez un sous-répertoire conf sous le répertoire racine de l’activateur activator-dist-1.3.10.
  3. Créez dans le répertoire conf un fichier vide nommé sbtconfig.txt.

Créer une nouvelle application avec CLI

Démarrez le cmd à partir du répertoire où une nouvelle application doit être créée. Le moyen le plus court de créer une nouvelle application via CLI consiste à fournir un nom d’application et un modèle en tant qu’arguments CLI :

  activator new my-play-app play-java

Il est possible de lancer uniquement :

  activator new

Dans ce cas, vous serez invité à sélectionner le modèle souhaité et un nom d’application.

Pour Play 2.4, ajoutez manuellement à project/plugins.sbt :

// Use the Play sbt plugin for Play projects
addSbtPlugin("com.typesafe.play" % "sbt-plugin" % "2.4.x")

Assurez-vous de remplacer ici 2.4.x par la version exacte que vous souhaitez utiliser. Play 2.5 génère cette ligne automatiquement.

Assurez-vous que la bonne version de sbt est mentionnée dans project/build.properties. Il doit correspondre à la version sbt, installée sur votre machine. Par exemple, pour Play2.4.x, cela devrait être :

sbt.version=0.13.8

Ça y est, une nouvelle application peut désormais être lancée :

  cd my-play-app
  activator run

Au bout d’un moment, le serveur démarrera et l’invite suivante devrait apparaître sur la console :

  [info] p.c.s.NettyServer - Listening for HTTP on /0:0:0:0:0:0:0:0:9000
  (Server started, use Ctrl+D to stop and go back to the console...)

Le serveur écoute par défaut sur le port 9000. Vous pouvez le demander à partir d’un navigateur par l’URL http://localhost:9000. Vous obtiendrez quelque chose comme ceci :

[![entrez la description de l’image ici][1]][1]

Exécution de l’activateur sur un port différent

Par défaut, l’activateur exécute une application sur le port 9000 pour http ou 443 pour https. Pour exécuter une application sur un autre port (http) :

activator "run 9005"

[1] : http://i.stack.imgur.com/D0dgS.png

Jouer 1 Installation

Conditions préalables

Pour exécuter le framework Play, vous avez besoin de Java 6 ou version ultérieure. Si vous souhaitez construire Play à partir de la source, vous aurez besoin du [client de contrôle de source Git][1] pour récupérer le code source et [Ant][2] pour le construire.

Assurez-vous d’avoir Java dans le chemin actuel (entrez java --version pour vérifier)

Play utilisera le Java par défaut ou celui disponible au chemin $JAVA_HOME s’il est défini.

L’utilitaire de ligne de commande play utilise Python. Il devrait donc fonctionner immédiatement sur n’importe quel système UNIX (cependant, il nécessite au moins Python 2.5).

Installation depuis le paquet binaire

Instructions génériques

En général, les instructions d’installation sont les suivantes.

  1. Installez Java.
  2. Téléchargez le [dernier paquet binaire Play][3] et extrayez l’archive.
  3. Ajoutez la commande ‘play’ à votre chemin système et assurez-vous qu’elle est exécutable.

Mac OS X

Java est intégré ou installé automatiquement, vous pouvez donc ignorer la première étape.

  1. Téléchargez le dernier package binaire Play et extrayez-le dans /Applications.
  2. Modifiez /etc/paths et ajoutez la ligne /Applications/play-1.2.5 (par exemple).

Une alternative sur OS X est :

  1. Installez [HomeBrew][4]
  2. Lancez brew install play

##Linux Pour installer Java, assurez-vous d’utiliser Sun-JDK ou OpenJDK (et non gcj qui est la commande Java par défaut sur de nombreuses distributions Linux)

Les fenêtres

Pour installer Java, téléchargez et installez simplement le dernier package JDK. Vous n’avez pas besoin d’installer Python séparément, car un runtime Python est fourni avec le framework.

[1] : https://git-scm.com/ [2] : http://ant.apache.org/ [3] : http://download.playframework.com/ [4] : http://mxcl.github.com/homebrew/

Installation via sbt

Si vous avez déjà installé sbt, je trouve plus facile de créer un projet Play minimal sans activateur. Voici comment.

# create a new folder
mkdir myNewProject
# launch sbt
sbt

Une fois les étapes précédentes terminées, modifiez build.sbt et ajoutez les lignes suivantes

name := """myProjectName"""

version := "1.0-SNAPSHOT"

offline := true

lazy val root = (project in file(".")).enablePlugins(PlayScala)
scalaVersion := "2.11.6"
# add required dependencies here .. below a list of dependencies I use
libraryDependencies ++= Seq(
  jdbc,
  cache,
  ws,
  filters,
  specs2 % Test,
  "com.github.nscala-time" %% "nscala-time" % "2.0.0",
  "javax.ws.rs" % "jsr311-api" % "1.0",
  "commons-io" % "commons-io" % "2.3",
  "org.asynchttpclient" % "async-http-client" % "2.0.4",
  cache
)


resolvers += "scalaz-bintray" at "http://dl.bintray.com/scalaz/releases"

resolvers ++= Seq("snapshots", "releases").map(Resolver.sonatypeRepo)

resolvers += "Typesafe Releases" at "http://repo.typesafe.com/typesafe/maven-releases/"

Enfin, créez un dossier project et créez à l’intérieur un fichier build.properties avec la référence à la version de Play que vous souhaitez utiliser

 addSbtPlugin("com.typesafe.play" % "sbt-plugin" % "2.4.3")

C’est ça! Votre projet est prêt. Vous pouvez le lancer avec sbt. Depuis sbt, vous avez accès aux mêmes commandes qu’avec activateur.