LUFA/StudioIntegration/makefile

   1 #
   2 #             LUFA Library
   3 #     Copyright (C) Dean Camera, 2013.
   4 #
   5 #  dean [at] fourwalledcubicle [dot] com
   6 #           www.lufa-lib.org
   7 #
   8 # ---------------------------------------
   9 #  Makefile for the LUFA Atmel Studio Integration.
  10 # ---------------------------------------
  11
  12 LUFA_ROOT            := ..
  13 LUFA_VERSION_NUM     := $(shell grep LUFA_VERSION_STRING $(LUFA_ROOT)/Version.h | cut -d'"' -f2)
  14 DOXYGEN_TAG_FILE_XML := $(LUFA_ROOT)/Documentation/lufa_doc_tags.xml
  15 DOXYGEN_COMBINED_XML := $(LUFA_ROOT)/Documentation/xml/lufa_doc.xml
  16 TEMP_MANIFEST_XML    := manifest.xml
  17 EXTENSION_OUTPUT_XML := $(LUFA_ROOT)/../extension.xml
  18 MODULE_OUTPUT_XML    := $(LUFA_ROOT)/asf.xml
  19 XML_FILES            := $(filter-out $(TEMP_MANIFEST_FILE), $(shell ls *.xml))
  20 VSIX_ASSETS          := $(LUFA_ROOT)/DoxygenPages/Images/LUFA_thumb.png \
  21                         $(LUFA_ROOT)/DoxygenPages/Images/LUFA.png       \
  22                         $(LUFA_ROOT)/License.txt                        \
  23                         VSIX/"[Content_Types].xml"                      \
  24                         VSIX/ASFExplorer.png                            \
  25                         VSIX/ASFWizard.png                              \
  26                         VSIX/NewExampleWizard.png                       \
  27                         VSIX/GettingStarted.htm                         \
  28                         Blob/Atmel.Studio.Services.Interfaces.dll       \
  29                         Blob/LUFA.dll                                   \
  30                         Blob/LUFA.pkgdef
  31
  32 ifneq ($(LUFA_VERSION_NUM),000000)
  33   EXT_VERSION_NUM    := $(shell date +"%y.%m.%d").$(LUFA_VERSION_NUM)
  34   EXT_VSIX_NAME      := LUFA-RELEASE-$(LUFA_VERSION_NUM).vsix
  35 else
  36   EXT_VERSION_NUM    := 0.$(shell date +"%y%m%d.%H%M%S")
  37   EXT_VSIX_NAME      := LUFA-TESTING-$(shell date +"%y.%m.%d-%H.%M.%S").vsix
  38
  39   $(warning No LUFA version set - assuming a test version should be created.)
  40 endif
  41
  42 all: generate_xml check_filenames generate_vsix
  43
  44 clean:
  45         @rm -f $(TEMP_MANIFEST_XML) $(MODULE_OUTPUT_XML) $(EXTENSION_OUTPUT_XML) $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML)
  46
  47 $(DOXYGEN_TAG_FILE_XML):
  48         @$(MAKE) -C ../ doxygen DOXYGEN_OVERRIDE_PARAMS="GENERATE_TAGFILE=Documentation/lufa_doc_tags.xml GENERATE_HTML=no GENERATE_XML=yes"
  49
  50 $(DOXYGEN_COMBINED_XML): $(DOXYGEN_TAG_FILE_XML)
  51         @xsltproc $(dir $@)/combine.xslt $(dir $@)/index.xml > $(DOXYGEN_COMBINED_XML)
  52
  53 $(TEMP_MANIFEST_XML): $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML)
  54         @echo "Generating Manifest XML..."
  55
  56         @printf "<lufa-manifest version=\"%s\" tagfile=\"%s\" docfile=\"%s\">\n" $(LUFA_VERSION_NUM) $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML) > $@
  57         @for i in $(XML_FILES); do \
  58                 printf "\t<xml-source filename=\"%s\"/>\n" $$i >> $@; \
  59         done;
  60         @echo '</lufa-manifest>' >> $@
  61
  62         @echo "Manifest XML file generated."
  63
  64 $(MODULE_OUTPUT_XML): $(TEMP_MANIFEST_XML)
  65         @echo "Processing asf.xml file..."
  66         @xsltproc XDK/lufa_module_transform.xslt $< | xsltproc XDK/lufa_indent_transform.xslt - > $(MODULE_OUTPUT_XML)
  67         @echo "Atmel Studio asf.xml file generated."
  68
  69 $(EXTENSION_OUTPUT_XML): $(TEMP_MANIFEST_XML)
  70         @echo "Processing extension.xml file..."
  71         @xsltproc XDK/lufa_extension_transform.xslt $< | xsltproc XDK/lufa_indent_transform.xslt - > $(EXTENSION_OUTPUT_XML)
  72         @echo "Atmel Studio extension.xml file generated."
  73
  74
  75 generate_xml: $(EXTENSION_OUTPUT_XML) $(MODULE_OUTPUT_XML)
  76
  77 generate_vsix: $(EXTENSION_OUTPUT_XML) $(MODULE_OUTPUT_XML)
  78         @echo "Cleaning all Projects..."
  79         @make -C $(LUFA_ROOT)/../ clean
  80
  81         @echo "Generating ASF cache files..."
  82         @rm -f $(LUFA_ROOT)/../content.xml.cache
  83         @rm -f $(LUFA_ROOT)/../ExampleProjects.xml
  84         @python VSIX/generate_caches.py $(LUFA_ROOT)/../
  85
  86         @echo "Archiving Content..."
  87         @rm -f contents.zip
  88         @cd $(LUFA_ROOT)/../ && zip contents.zip -q -0 -r --exclude=*Documentation* --exclude=*StudioIntegration* LUFA Bootloaders Demos Projects README.txt
  89
  90         @echo "Creating VSIX Dependencies..."
  91         @cp $(VSIX_ASSETS) $(LUFA_ROOT)/..
  92         @xsltproc --stringparam extension-version "$(EXT_VERSION_NUM)" VSIX/lufa_vsmanifest_transform.xslt VSIX/extension.vsixmanifest > $(LUFA_ROOT)/../extension.vsixmanifest
  93         @xsltproc --stringparam lufa-version "$(LUFA_VERSION_NUM)" VSIX/lufa_asfmanifest_transform.xslt VSIX/asf-manifest.xml > $(LUFA_ROOT)/../asf-manifest.xml
  94
  95         @echo "Generating Atmel Studio VSIX Extension file..."
  96         cd $(LUFA_ROOT)/../ && zip $(EXT_VSIX_NAME) -q -9 contents.zip exampleProjects.xml content.xml.cache extension.vsixmanifest asf-manifest.xml extension.xml $(notdir $(VSIX_ASSETS))
  97         @echo "Atmel Studio VSIX Extension file generated."
  98
  99 check_filenames: $(MODULE_OUTPUT_XML)
 100         @echo Verifying referenced filenames of ASF.xml modules...
 101         @for f in `find $(LUFA_ROOT)/../ -name "asf.xml"`; do \
 102                 echo "Checking $$f..."; \
 103                 asf_file_dir=`dirname $$f`; \
 104                 xsltproc XDK/lufa_filelist_transform.xslt $$f | sed -e "/^$$/d" | while read -r i; do \
 105                         if ( ! test -f "$$asf_file_dir/$$i" ); then \
 106                                 echo "Source file \"$$i\" referenced in $$f does not exist!"; \
 107                                 exit 1; \
 108                         fi; \
 109                 done || exit 1; \
 110         done;
 111         @echo Verified referenced filenames of ASF.xml modules.
 112
 113 sanity_check:
 114         python ProjectGenerator/project_generator.py -b $(LUFA_ROOT)/../ --main-ext-uuid=0e160d5c-e331-48d9-850b-e0387912171b CHECK
 115
 116 .PHONY: all clean generate_xml generate_vsix check_filenames