AdRock

AdRock

Faites vibrer le monde AdHoc ! ?

Exigences

• Nœud 4.3+
• Exprimer 4.11+

Mise en place

• Clonage du dépôt :

git clone https://github.com/FoundersFactory/AdRock.git

• Installation pour toujours :

npm install forever -g

• Créez un fichier .env :

cd Server && touch .env

• Connectez-vous à Auth0, créez un client pour AdRock et configurez le fichier .env avec vos informations :

 AUTH0_CLIENT_ID= 
AUTH0_CLIENT_SECRET= 
AUTH0_DOMAIN=<your-company-name>.eu.auth0.com 
AUTH0_CALLBACK_URL=http://localhost:3000/adrock
PORT=3000
HOST=localhost
EXTERNAL_URL=https://example.com

• Extraire les modifications et exécuter l'application (à partir de /Server ) :

 forever stopall && git pull && npm install --save && 
NODE_ENV=production forever --minUptime 1000 --spinSleepTime 1000 start ./forever.json

Cela va :

0. démarrez l'application express par défaut sur le port 3000
1. créer un point de terminaison GET <domain>/adrock/<full-app-bundle-id>
2. créer un point de terminaison POST <domain>/adrock/upload pour recevoir des applications

Exprimer

Si vous possédez déjà une application express et souhaitez y intégrer AdRock :

 //Requires
const dotenv = require("dotenv");
const jwt = require("express-jwt");
const cors = require("cors");

//Other stuff you might want to do
{...}

//Loading the environment variables and Auth0
dotenv.load();

const authenticate = jwt({
	secret: new Buffer(process.env.AUTH0_CLIENT_SECRET, 'base64'),
	audience: process.env.AUTH0_CLIENT_ID
});

//Other stuff you might want to do, especially creating your express app
{...}

//ADROCK!!!
//Getting apps
app.use("/adrock", require("./routes/get"));

//Auth
app.use("/adrock/upload", authenticate);

//Uploading apps
app.use("/adrock/upload", require("./routes/post"));
app.use(function (err, req, res, next) {
	if (err.name === 'UnauthorizedError') {
		res.status(401).send('Invalid token...');
		return;
	}
	next(err);
});

Nginx

Si vous utilisez Nginx, ajoutez ceci à votre fichier .conf principal :

 location /adrock {
	include	/<path-to-adrock>/Server/nginx.conf;
}

Utiliser AdRock

Pour télécharger une nouvelle application ou une nouvelle version d'une application existante, vous devrez envoyer une requête POST en plusieurs parties à <domain>/adrock/upload contenant :

• JWT d'Auth0
• (champ du formulaire) app => un fichier .ipa ou .apk d'une taille maximale de 512 Mo
• icon => un fichier .png pour l'icône de l'application (nécessaire uniquement lors du premier téléchargement et pour les applications iOS)
• bundleId => l'identifiant de bundle complet de l'application (par exemple com.example.raddest-app-ever )
• version => La version de l'application (ex. 0.3.1 )
• name => Le nom de l'application (par exemple Raddest App Ever )

En cas de succès, vous obtiendrez l'URL du index.html de l'application, ce qui revient à appeler <domain>/adrock/<full-app-bundle-id> .

Exemple:

	curl -X POST <domain>/adrock/upload 
		-H Authorization=Bearer <your-jwt>
		-F app=<path/to/ipa>
		-F icon=<path/to/icon>
		-F bundleId=<full-app-bundle-id>
		-F name='The App's Name'
		-F version=0.3.1