[bazel] Handle debug symbols and debug builds like gradle (#8118)

This follows the gradle build accurately.  Gradle copies debug symbols
into a second file (libfoo.so.debug) and links it back into the .so
file.  Disable this behavior when gradle doesn't do it today.

Also, name everything correctly.  When building debug builds, most
libraries get a 'd' at the end of them.  Do that here too.

apriltag/BUILD.bazel

@@ -113,6 +113,7 @@ wpilib_cc_shared_library(
         "//wpimath:shared/wpimath",
         "//wpiutil:shared/wpiutil",
     ],
+    use_debug_name = False,
     visibility = ["//visibility:public"],
     deps = [":apriltagjni"],
 )