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
  15 ifneq ($(LUFA_VERSION_NUM),000000)
  16   EXT_VERSION_NUM    := $(shell date +"%y.%m.%d").$(LUFA_VERSION_NUM)
  17   EXT_VSIX_NAME      := LUFA-RELEASE-$(LUFA_VERSION_NUM).vsix
  18 else
  19   EXT_VERSION_NUM    := 0.$(shell date +"%y%m%d.%H%M%S")
  20   EXT_VSIX_NAME      := LUFA-TESTING-$(shell date +"%y.%m.%d-%H.%M.%S").vsix
  21
  22   $(warning No LUFA version set - assuming a test version should be created.)
  23 endif
  24
  25 DOXYGEN_TAG_FILE_XML := $(LUFA_ROOT)/Documentation/lufa_doc_tags.xml
  26 DOXYGEN_COMBINED_XML := $(LUFA_ROOT)/Documentation/xml/lufa_doc.xml
  27 TEMP_MANIFEST_XML    := manifest.xml
  28 EXTENSION_OUTPUT_XML := $(LUFA_ROOT)/../extension.xml
  29 MODULE_OUTPUT_XML    := $(LUFA_ROOT)/asf.xml
  30 MSHELP_OUTPUT_XML    := $(LUFA_ROOT)/../lufa_help_$(EXT_VERSION_NUM).mshc
  31 XML_FILES            := $(filter-out $(TEMP_MANIFEST_FILE), $(shell ls *.xml))
  32 VSIX_ASSETS          := $(LUFA_ROOT)/DoxygenPages/Images/LUFA_thumb.png     \
  33                         $(LUFA_ROOT)/DoxygenPages/Images/LUFA.png           \
  34                         $(LUFA_ROOT)/License.txt                            \
  35                         VSIX/"[Content_Types].xml"                          \
  36                         VSIX/LUFA.dll                                       \
  37                         VSIX/LUFA.pkgdef
  38 VSIX_GEN_PARAMS     := --stringparam extension-version "$(EXT_VERSION_NUM)" \
  39                        --stringparam lufa-version "$(LUFA_VERSION_NUM)"
  40 MSHELP_GEN_PARAMS   := --stringparam generate.toc "book toc"                \
  41                        --stringparam chunk.quietly "1"                      \
  42                        --stringparam chunk.section.depth "3"                \
  43                        --stringparam chunk.first.sections "1"               \
  44                        --stringparam chapter.autolabel "0"                  \
  45                        --stringparam root.filename "LUFA"                   \
  46                        --stringparam html.stylesheet "lufa_studio_help_styling.css"
  47
  48 all: clear_project_dirs generate_xml check_filenames generate_vsix
  49
  50 clear_project_dirs:
  51         @make -s -C $(LUFA_ROOT)/.. clean
  52
  53 clean:
  54         @rm -f $(TEMP_MANIFEST_XML) $(MODULE_OUTPUT_XML) $(EXTENSION_OUTPUT_XML) $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML) $(MSHELP_OUTPUT_XML)
  55         @rm -rf mshelp
  56         @cd $(LUFA_ROOT)/.. && rm -f contents.zip exampleProjects.xml content.xml.cache extension.vsixmanifest asf-manifest.xml extension.xml helpcontentsetup.msha $(notdir $(VSIX_ASSETS)) *.vsix *.mshc
  57
  58 $(DOXYGEN_TAG_FILE_XML):
  59         @$(MAKE) -C ../ doxygen DOXYGEN_OVERRIDE_PARAMS="GENERATE_TAGFILE=Documentation/lufa_doc_tags.xml GENERATE_HTML=no GENERATE_XML=yes"
  60
  61 $(DOXYGEN_COMBINED_XML): $(DOXYGEN_TAG_FILE_XML)
  62         @xsltproc $(dir $@)/combine.xslt $(dir $@)/index.xml > $(DOXYGEN_COMBINED_XML)
  63
  64 $(TEMP_MANIFEST_XML): $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML)
  65         @echo Generating temporary module manifest XML...
  66
  67         @printf "<lufa-manifest version=\"%s\" tagfile=\"%s\" docfile=\"%s\">\n" $(LUFA_VERSION_NUM) $(DOXYGEN_TAG_FILE_XML) $(DOXYGEN_COMBINED_XML) > $@
  68         @for i in $(XML_FILES); do \
  69                 printf "\t<xml-source filename=\"%s\"/>\n" $$i >> $@; \
  70         done;
  71         @echo '</lufa-manifest>' >> $@
  72
  73 $(MODULE_OUTPUT_XML): $(TEMP_MANIFEST_XML)
  74         @echo Generating library core XDK module manifest file...
  75         @xsltproc XDK/lufa_module_transform.xslt $< | xsltproc XDK/lufa_indent_transform.xslt - > $(MODULE_OUTPUT_XML)
  76
  77 $(EXTENSION_OUTPUT_XML): $(TEMP_MANIFEST_XML)
  78         @echo Generating library XDK extension manifest file...
  79         @xsltproc XDK/lufa_extension_transform.xslt $< | xsltproc XDK/lufa_indent_transform.xslt - > $(EXTENSION_OUTPUT_XML)
  80
  81 $(MSHELP_OUTPUT_XML): $(DOXYGEN_COMBINED_XML)
  82         @echo Converting Doxygen XML to DocBook...
  83         @-mkdir mshelp 2> /dev/null
  84         @xsltproc HV1/lufa_docbook_transform.xslt $(DOXYGEN_COMBINED_XML) > mshelp/lufa_docbook.xml
  85
  86         @echo Converting DocBook XML to Microsoft Help 1.0...
  87         @cd mshelp && xsltproc $(MSHELP_GEN_PARAMS) ../HV1/lufa_hv1_transform.xslt lufa_docbook.xml
  88
  89         @echo Copying help assets...
  90         @cp HV1/lufa_studio_help_styling.css mshelp
  91         @-mkdir mshelp/images 2> /dev/null
  92         @cp `find $(LUFA_ROOT)/DoxygenPages/Images -type f` mshelp/images
  93
  94         @echo Archiving help content...
  95         @cd mshelp && zip ../$(MSHELP_OUTPUT_XML) -q -0  -r *.html *.css images
  96
  97         @echo Generating HV1 manifest...
  98         @xsltproc $(VSIX_GEN_PARAMS) HV1/lufa_helpcontentsetup_transform.xslt HV1/helpcontentsetup.msha > $(LUFA_ROOT)/../helpcontentsetup.msha
  99
 100 generate_help: $(MSHELP_OUTPUT_XML)
 101
 102 generate_xml: $(EXTENSION_OUTPUT_XML) $(MODULE_OUTPUT_XML)
 103
 104 generate_vsix: $(EXTENSION_OUTPUT_XML) $(MODULE_OUTPUT_XML) $(MSHELP_OUTPUT_XML)
 105         @echo Generating XDK cache files...
 106         @rm -f $(LUFA_ROOT)/../content.xml.cache
 107         @rm -f $(LUFA_ROOT)/../ExampleProjects.xml
 108         @python VSIX/generate_caches.py $(LUFA_ROOT)/../
 109
 110         @echo Archiving XDK content...
 111         @rm -f contents.zip
 112         @cd $(LUFA_ROOT)/../ && zip contents.zip -q -0 -r --exclude=*Documentation* --exclude=*StudioIntegration* LUFA Bootloaders Demos Projects README.txt
 113
 114         @echo Creating VSIX dependencies...
 115         @cp $(VSIX_ASSETS) $(LUFA_ROOT)/..
 116         @xsltproc $(VSIX_GEN_PARAMS) VSIX/lufa_vsmanifest_transform.xslt VSIX/extension.vsixmanifest > $(LUFA_ROOT)/../extension.vsixmanifest
 117         @xsltproc $(VSIX_GEN_PARAMS) VSIX/lufa_asfmanifest_transform.xslt VSIX/asf-manifest.xml > $(LUFA_ROOT)/../asf-manifest.xml
 118
 119         @echo Generating Atmel Studio VSIX file...
 120         cd $(LUFA_ROOT)/../ && zip $(EXT_VSIX_NAME) -q -9 contents.zip exampleProjects.xml content.xml.cache extension.vsixmanifest asf-manifest.xml extension.xml helpcontentsetup.msha $(notdir $(MSHELP_OUTPUT_XML)) $(notdir $(VSIX_ASSETS))
 121
 122         @echo "Atmel Studio VSIX extension file generated."
 123
 124 check_filenames: $(MODULE_OUTPUT_XML)
 125         @echo Verifying referenced filenames of XDK modules...
 126         @for f in `find $(LUFA_ROOT)/../ -name "asf.xml"`; do \
 127                 echo "Checking $$f..."; \
 128                 asf_file_dir=`dirname $$f`; \
 129                 xsltproc XDK/lufa_filelist_transform.xslt $$f | sed -e "/^$$/d" | while read -r i; do \
 130                         if ( ( ! test -f "$$asf_file_dir/$$i" ) && ( ! test -d "$$asf_file_dir/$$i" ) ); then \
 131                                 echo "Source file \"$$i\" referenced in $$f does not exist!"; \
 132                                 exit 1; \
 133                         fi; \
 134                 done || exit 1; \
 135         done;
 136
 137 check_database:
 138         python ProjectGenerator/project_generator.py -b $(LUFA_ROOT)/../ --main-ext-uuid=0e160d5c-e331-48d9-850b-e0387912171b CHECK
 139
 140 .PHONY: all clean generate_help generate_xml generate_vsix check_filenames check_database