This page
Other pages
Account
About the Blackboard version compatibility checker
Blackboard now provides an experimental service called FIBBBA to help Blackboard developers determine which APIs are most likely to cause incompatibilities with certain versions of Blackboard. You may download it here. If you have any problems using FIBBBA, please e-mail us at edugarage@blackboard.com
antTask.jar
The ant task will upload the specified b2 to Fibbba, ingest it, analyze it, and fail the build if incompatibilities are found. Fibbba will respect the min & max version specified in your bb-manifest when deciding which versions of Learn to check compatibility against.
<taskdef name="checkFibbba" classname="com.blackboard.fibbba.CheckFibbbaTask" classpath="${basedir}/lib/antTask.jar" /> <target name="checkFibbba"> <checkFibbba srcfile="dist/myB2.war" email="youremailaddress@gmail.com"/> </target>
Sample Output
[user@machine] ~/source/learn/b2/myB2/mainline $ ant checkFibbba Buildfile: /Users/user/source/learn/b2/myB2/mainline/build.xml checkFibbba: [checkFibbba] Pushing <dist/myB2.war> to <http://fibbba.blackboard.com/fibbbaServer/submitFile/postB2> BUILD FAILED /Users/user/source/learn/b2/myB2/mainline/build.xml:34: The B2 was found to be incompatible with Learn build <9.1.407.2;9.1.407.9;>. Missing methods are: 9.1.407.2: class name: <blackboard.platform.contentsystem.manager.DocumentManager> method signature: <blackboard.platform.contentsystem.data.Resource loadResource(java.lang.String)> 9.1.407.9: class name: <blackboard.platform.contentsystem.manager.DocumentManager> method signature: <blackboard.platform.contentsystem.data.Resource loadResource(java.lang.String)> Total time: 1 minute 42 seconds
Task options
| Name | Required | Description |
|---|---|---|
| srcfile | yes | specifies which file to upload to Fibbba. This is your war file. |
| yes | a contact email for the b2 | |
| failOnJsp | no | defaults to true. Specifies whether or not failure to compile the JSPs should be considered a build failure. |
| requiredBuilds | no | A semi-colon delimited list of Learn version numbers (e.g. '9.1.407.2;9.0.670.0') Specifies versions of Learn to test compatibility with. If all of the requiredBuilds succeeded, the build is successful. |
 | To perform its compatibility testing function, this developmental tool will decompile the object code of your Building Block to identify the individual API calls made to various versions of Blackboard Learn. In addition, this tool will store information regarding the individual API calls made by your Building Block, to allow Blackboard to make future modifications and improvements to its API libraries. THIS TOOL IS FOR ADVISORY PURPOSES ONLY, and does not represent a quality assurance test or other certification of the compatibility of your Building Block with any version of Blackboard Learn. Furthermore, THIS TOOL IS DEVELOPMENTAL, and therefore may be modified or discontinued at any time. Please click "I agree" when downloading the script to indicate your understanding and acknowledgment of these supplemental terms of service. |