From Xojo Documentation
|You are currently browsing the old Xojo documentation site. Please visit the new Xojo documentation site!|
In the process of creating an application that runs on multiple platforms, you may find that you have some code that is only needed on a single platform. An example of this might be code that saves preferences. On Windows you might want to use the Registry, but on Mac you might want to use a plist. You can handle these special cases using conditional compilation.
With conditional compilation, you are telling the compiler to include or exclude specific parts of your code depending on what is platform and/or target being compiled. This is done using the #If command in conjunction with #Else, #ElseIf and #Endif.
You can use these commands along with any constant to selectively include or exclude code when building. There are many built-in compiler constants you can use with conditional compilation. Some commonly used constants include:
For example if you have code that should only be included when you are running in debug mode from the IDE, you would do this:
This code could be used to handle saving preferences differently based on platform:
// Use Registry
#ElseIf TargetMacOS Then
// Use a plist
#ElseIf TargetLinux Then
// Use generic XML
You can even use your own constants, such as this to check if a beta has expired:
// Check if the beta has expired
If Xojo.Date.Now.Year > 2015 Then
For more information, refer to # If... # Endif in the Language Reference.
Selecting a Target for a Class/Method in Inspector
You can indicate that a particular project item (excluding Windows, Web Pages and iOS Views) should only be included for certain project types. For example, you may have a class that you only want to include when you are creating a web app. You do this using the “Include In” properties in the Advanced tab of the Inspector (the are often referred to as Compatibility Flags). To get to the Advanced tab, click the gear button at the top of the Inspector. This shows the advanced options. The "Include In" section has properties for the target (Desktop, Web, Console, IOS) and architecture (32-bit or 64-bit). By default everything is checked, but you can check any combination.
When your project is being built, the project item gets excluded from any target/architecture that does not match what is checked.
You can also set “Include In” for methods, properties, constants, event definitions, enums, structures, delegates and anything else you can add to a project item.