1 # Copyright 2015 Google Inc. All rights reserved. 2 # 3 # Licensed under the Apache License, Version 2.0 (the "License"); 4 # you may not use this file except in compliance with the License. 5 # You may obtain a copy of the License at 6 # 7 # http://www.apache.org/licenses/LICENSE-2.0 8 # 9 # Unless required by applicable law or agreed to in writing, software 10 # distributed under the License is distributed on an "AS IS" BASIS, 11 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 # See the License for the specific language governing permissions and 13 # limitations under the License. 14 15 # General function to create FlatBuffer build rules for the given list of 16 # schemas. 17 # 18 # flatbuffers_schemas: A list of flatbuffer schema files to process. 19 # 20 # schema_include_dirs: A list of schema file include directories, which will be 21 # passed to flatc via the -I parameter. 22 # 23 # custom_target_name: The generated files will be added as dependencies for a 24 # new custom target with this name. You should add that target as a dependency 25 # for your main target to ensure these files are built. You can also retrieve 26 # various properties from this target, such as GENERATED_INCLUDES_DIR, 27 # BINARY_SCHEMAS_DIR, and COPY_TEXT_SCHEMAS_DIR. 28 # 29 # additional_dependencies: A list of additional dependencies that you'd like 30 # all generated files to depend on. Pass in a blank string if you have none. 31 # 32 # generated_includes_dir: Where to generate the C++ header files for these 33 # schemas. The generated includes directory will automatically be added to 34 # CMake's include directories, and will be where generated header files are 35 # placed. This parameter is optional; pass in empty string if you don't want to 36 # generate include files for these schemas. 37 # 38 # binary_schemas_dir: If you specify an optional binary schema directory, binary 39 # schemas will be generated for these schemas as well, and placed into the given 40 # directory. 41 # 42 # copy_text_schemas_dir: If you want all text schemas (including schemas from 43 # all schema include directories) copied into a directory (for example, if you 44 # need them within your project to build JSON files), you can specify that 45 # folder here. All text schemas will be copied to that folder. 46 # 47 # IMPORTANT: Make sure you quote all list arguments you pass to this function! 48 # Otherwise CMake will only pass in the first element. 49 # Example: build_flatbuffers("${fb_files}" "${include_dirs}" target_name ...) 50 function(build_flatbuffers flatbuffers_schemas 51 schema_include_dirs 52 custom_target_name 53 additional_dependencies 54 generated_includes_dir 55 binary_schemas_dir 56 copy_text_schemas_dir) 57 58 # Test if including from FindFlatBuffers 59 if(FLATBUFFERS_FLATC_EXECUTABLE) 60 set(FLATC_TARGET "") 61 set(FLATC ${FLATBUFFERS_FLATC_EXECUTABLE}) 62 else() 63 set(FLATC_TARGET flatc) 64 set(FLATC flatc) 65 endif() 66 set(FLATC_SCHEMA_ARGS --gen-mutable) 67 if(FLATBUFFERS_FLATC_SCHEMA_EXTRA_ARGS) 68 set(FLATC_SCHEMA_ARGS 69 ${FLATBUFFERS_FLATC_SCHEMA_EXTRA_ARGS} 70 ${FLATC_SCHEMA_ARGS} 71 ) 72 endif() 73 74 set(schema_glob "*.fbs") 75 # Generate the include files parameters. 76 set(include_params "") 77 set(all_generated_files "") 78 foreach (include_dir ${schema_include_dirs}) 79 set(include_params -I ${include_dir} ${include_params}) 80 if (NOT ${copy_text_schemas_dir} STREQUAL "") 81 # Copy text schemas from dependent folders. 82 file(GLOB_RECURSE dependent_schemas ${include_dir}/${schema_glob}) 83 foreach (dependent_schema ${dependent_schemas}) 84 file(COPY ${dependent_schema} DESTINATION ${copy_text_schemas_dir}) 85 endforeach() 86 endif() 87 endforeach() 88 89 foreach(schema ${flatbuffers_schemas}) 90 get_filename_component(filename ${schema} NAME_WE) 91 # For each schema, do the things we requested. 92 if (NOT ${generated_includes_dir} STREQUAL "") 93 set(generated_include ${generated_includes_dir}/${filename}_generated.h) 94 add_custom_command( 95 OUTPUT ${generated_include} 96 COMMAND ${FLATC} ${FLATC_SCHEMA_ARGS} 97 -o ${generated_includes_dir} 98 ${include_params} 99 -c ${schema} 100 DEPENDS ${FLATC_TARGET} ${schema} ${additional_dependencies}) 101 list(APPEND all_generated_files ${generated_include}) 102 endif() 103 104 if (NOT ${binary_schemas_dir} STREQUAL "") 105 set(binary_schema ${binary_schemas_dir}/${filename}.bfbs) 106 add_custom_command( 107 OUTPUT ${binary_schema} 108 COMMAND ${FLATC} -b --schema 109 -o ${binary_schemas_dir} 110 ${include_params} 111 ${schema} 112 DEPENDS ${FLATC_TARGET} ${schema} ${additional_dependencies}) 113 list(APPEND all_generated_files ${binary_schema}) 114 endif() 115 116 if (NOT ${copy_text_schemas_dir} STREQUAL "") 117 file(COPY ${schema} DESTINATION ${copy_text_schemas_dir}) 118 endif() 119 endforeach() 120 121 # Create a custom target that depends on all the generated files. 122 # This is the target that you can depend on to trigger all these 123 # to be built. 124 add_custom_target(${custom_target_name} 125 DEPENDS ${all_generated_files} ${additional_dependencies}) 126 127 # Register the include directory we are using. 128 if (NOT ${generated_includes_dir} STREQUAL "") 129 include_directories(${generated_includes_dir}) 130 set_property(TARGET ${custom_target_name} 131 PROPERTY GENERATED_INCLUDES_DIR 132 ${generated_includes_dir}) 133 endif() 134 135 # Register the binary schemas dir we are using. 136 if (NOT ${binary_schemas_dir} STREQUAL "") 137 set_property(TARGET ${custom_target_name} 138 PROPERTY BINARY_SCHEMAS_DIR 139 ${binary_schemas_dir}) 140 endif() 141 142 # Register the text schema copy dir we are using. 143 if (NOT ${copy_text_schemas_dir} STREQUAL "") 144 set_property(TARGET ${custom_target_name} 145 PROPERTY COPY_TEXT_SCHEMAS_DIR 146 ${copy_text_schemas_dir}) 147 endif() 148 endfunction() 149
