# This file is licensed under the Affero General Public License version 3 or # later. See the COPYING file. # @author Bernhard Posselt # @copyright Bernhard Posselt 2016 # Generic Makefile for building and packaging a Nextcloud app which uses npm and # Composer. # # Dependencies: # * make # * which # * curl: used if phpunit and composer are not installed to fetch them from the web # * tar: for building the archive # * npm: for building and testing everything JS # # If no composer.json is in the app root directory, the Composer step # will be skipped. The same goes for the package.json which can be located in # the app root or the js/ directory. # # The npm command by launches the npm build script: # # npm run build # # The npm test command launches the npm test script: # # npm run test # # The idea behind this is to be completely testing and build tool agnostic. All # build tools and additional package managers should be installed locally in # your project, since this won't pollute people's global namespace. # # The following npm scripts in your package.json install and update the bower # and npm dependencies and use gulp as build system (notice how everything is # run from the node_modules folder): # # "scripts": { # "test": "node node_modules/gulp-cli/bin/gulp.js karma", # "prebuild": "npm install && node_modules/bower/bin/bower install && node_modules/bower/bin/bower update", # "build": "node node_modules/gulp-cli/bin/gulp.js" # }, app_name=$(notdir $(CURDIR)) build_tools_directory=$(CURDIR)/build/tools source_build_directory=$(CURDIR)/build/source/news source_artifact_directory=$(CURDIR)/build/artifacts/source source_package_name=$(source_artifact_directory)/$(app_name) appstore_build_directory=$(CURDIR)/build/appstore/news appstore_artifact_directory=$(CURDIR)/build/artifacts/appstore appstore_package_name=$(appstore_artifact_directory)/$(app_name) npm=$(shell which npm 2> /dev/null) composer=$(shell which composer 2> /dev/null) # code signing # assumes the following: # * the app is inside the nextcloud/apps folder # * the private key is located in ~/.nextcloud/news.key # * the certificate is located in ~/.nextcloud/news.crt occ=$(CURDIR)/../../occ private_key=$(HOME)/.nextcloud/$(app_name).key certificate=$(HOME)/.nextcloud/$(app_name).crt sign=php -f $(occ) integrity:sign-app --privateKey="$(private_key)" --certificate="$(certificate)" sign_skip_msg="Skipping signing, either no key and certificate found in $(private_key) and $(certificate) or occ can not be found at $(occ)" ifneq (,$(wildcard $(private_key))) ifneq (,$(wildcard $(certificate))) ifneq (,$(wildcard $(occ))) CAN_SIGN=true endif endif endif all: build # Fetches the PHP and JS dependencies and compiles the JS. If no composer.json # is present, the composer step is skipped, if no package.json or js/package.json # is present, the npm step is skipped .PHONY: build build: make composer make npm # Installs and updates the composer dependencies. If composer is not installed # a copy is fetched from the web .PHONY: composer composer: ifeq (, $(composer)) @echo "No composer command available, downloading a copy from the web" mkdir -p $(build_tools_directory) curl -sS https://getcomposer.org/installer | php mv composer.phar $(build_tools_directory) php $(build_tools_directory)/composer.phar install --prefer-dist php $(build_tools_directory)/composer.phar update --prefer-dist else composer install --prefer-dist composer update --prefer-dist endif # Installs npm dependencies .PHONY: npm npm: cd js && $(npm) run build # Removes the appstore build .PHONY: clean clean: rm -rf ./build # Same as clean but also removes dependencies installed by composer, bower and # npm .PHONY: distclean distclean: clean rm -rf vendor rm -rf node_modules rm -rf js/vendor rm -rf js/node_modules # Builds the source and appstore package .PHONY: dist dist: make source make appstore # Builds the source package .PHONY: source source: rm -rf $(source_build_directory) $(source_artifact_directory) mkdir -p $(source_build_directory) $(source_artifact_directory) rsync -rv . $(source_build_directory) \ --exclude=/.git/ \ --exclude=/.idea/ \ --exclude=/build/ \ --exclude=/js/node_modules/ \ --exclude=*.log ifdef CAN_SIGN $(sign) --path "$(source_build_directory)" else @echo $(sign_skip_msg) endif tar -cvzf $(source_package_name).tar.gz -C $(source_build_directory)/../ $(app_name) # Builds the source package for the app store, ignores php and js tests .PHONY: appstore appstore: rm -rf $(appstore_build_directory) $(appstore_artifact_directory) mkdir -p $(appstore_build_directory) $(appstore_artifact_directory) cp --parents -r \ "appinfo" \ "css" \ "img" \ "l10n" \ "lib" \ "templates" \ "vendor" \ "COPYING" \ "AUTHORS.md" \ "CHANGELOG.md" \ "js/vendor/js-url/url.min.js" \ "js/vendor/es6-shim/es6-shim.min.js" \ "js/vendor/angular/angular.min.js" \ "js/vendor/angular-animate/angular-animate.min.js" \ "js/vendor/angular-route/angular-route.min.js" \ "js/vendor/angular-sanitize/angular-sanitize.min.js" \ "js/vendor/momentjs/min/moment-with-locales.min.js" \ "js/vendor/masonry/dist/masonry.pkgd.min.js" \ "js/build/app.min.js" \ "js/admin/Admin.js" \ $(appstore_build_directory) ifdef CAN_SIGN $(sign) --path="$(appstore_build_directory)" else @echo $(sign_skip_msg) endif tar -czf $(appstore_package_name).tar.gz -C $(appstore_build_directory)/../ $(app_name) # Command for running JS and PHP tests. Works for package.json files in the js/ # and root directory. If phpunit is not installed systemwide, a copy is fetched # from the internet .PHONY: test test: cd js && $(npm) run test ifeq (, $(shell which phpunit 2> /dev/null)) @echo "No phpunit command available, downloading a copy from the web" mkdir -p $(build_tools_directory) curl -sSL https://phar.phpunit.de/phpunit.phar -o $(build_tools_directory)/phpunit.phar php $(build_tools_directory)/phpunit.phar -c phpunit.xml --coverage-clover build/php-unit.clover php $(build_tools_directory)/phpunit.phar -c phpunit.integration.xml --coverage-clover build/php-integration.clover else phpunit -c phpunit.xml --coverage-clover build/php-unit.clover phpunit -c phpunit.integration.xml --coverage-clover build/php-unit.clover endif