Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-9370

Add section about debug symbols to Couchbase Lite C

    XMLWordPrintable

Details

    • 1

    Description

      Each of the "desktop" variants of C (Windows, macOS, Debian, Ubuntu, Raspbian) should indicate that debug symbols are available for download. The URL will be the same as the URL for the actual package download, with -symbols appended.

      E.g.
      https://packages.couchbase.com/releases/couchbase-lite-c/3.0.0-beta02/couchbase-lite-c-enterprise-3.0.0-beta02-macos.zip

      BECOMES

      https://packages.couchbase.com/releases/couchbase-lite-c/3.0.0-beta02/couchbase-lite-c-enterprise-3.0.0-beta02-macos-symbols.zip

      This will start, ideally, from beta03

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          jimb Jim Borden added a comment -

          NOTE: For the mobile variants, the symbols are included in the main package:

          iOS -> dSYM folder inside the xcframework
          Android -> Compiled into the .so files

          In case you want to make a note of that.

          jimb Jim Borden added a comment - NOTE : For the mobile variants, the symbols are included in the main package: iOS -> dSYM folder inside the xcframework Android -> Compiled into the .so files In case you want to make a note of that.

          Ian Bridge  Check if dup of DOC-9406

          priya.rajagopal Priya Rajagopal added a comment - Ian Bridge   Check if dup of DOC-9406
          Ian.bridge Ian Bridge added a comment -

          Jim Borden Priya Rajagopal 

          Staged here for review https://ibsoln.github.io/stage/3.0-GA/couchbase-lite/current/c/gs-install.html

          Changes includes TIP on debug symbol availability and direction to updated Downloads page with links

          Ian.bridge Ian Bridge added a comment - Jim Borden Priya Rajagopal   Staged here for review https://ibsoln.github.io/stage/3.0-GA/couchbase-lite/current/c/gs-install.html Changes includes TIP on debug symbol availability and direction to updated Downloads page with links
          jimb Jim Borden added a comment -

          While I'm here, might as well review the whole page:

          • "The binary release download comprises a root directory (libcblite-community-3.0.0 or libcblite-3.0.0), which contains" Both are libcblite-3.0.0, even community
          • "For Android, a ready-to-adapt, skeleton application project." Not sure what this is referring to, the Android package is include / lib just like the other desktop
          • "For Android and iOS the symbol version is incorporated in the standard release package." -> symbol version is -> symbols are
          • "From within the root directory, libcblite-community-3.0.0, deploy" (multiple locations) -> libcblite-community -> libcblite
          • "Direct access from Swift to Couchbase Lite for C is not possible in this 3.0.0 (beta) release." -> 3.0.0 not 3.0.0 (beta)
          • "Drag libcblite.3.dylib into your Xcode project, within the dialog" -> not 100% sure this works, might need to be libcblite.3.0.0.dylib, as libcblite.3.dylib is a symlink
          • "Within Android Studio, select and open the project folder (within the libcblite-community-3.0.0 or libcblite-3.0.0 folder)" ->both are libcblite-3.0.0 inside
          • "Once the install is finished, you can build and run this skeleton app." -> what skeleton app?

          homebrew installation will also be available shortly after GA, and so those instructions ( brew install libcblite and brew install libcblite-community should be included.

          The table split between Debian 9 and 9 Desktop is still confusing to me, even 20.04 Desktop vs Core I don't think is needed.  I think grouping the versions together so just, for example, Debian 9 shows all three architectures would be fine.  Also Ubuntu 20.04 is missing arm32.  iOS is also missing x86 and arm32.

          As for the download links, the link text for Windows symbols is "macos" on both CE and EE and there are no symbols packages for debs, only for the tarballs (i.e. couchbase-lite-c-enterprise-3.0.0-debian10-x86_64.tar.gz has one but libcblite-dev-enterprise_3.0.0-debian10_amd64.deb does not).

          jimb Jim Borden added a comment - While I'm here, might as well review the whole page: "The binary release download comprises a root directory (libcblite-community-3.0.0 or libcblite-3.0.0), which contains" Both are libcblite-3.0.0, even community "For Android, a ready-to-adapt , skeleton application project." Not sure what this is referring to, the Android package is include / lib just like the other desktop "For Android and iOS the symbol version is incorporated in the standard release package." -> symbol version is -> symbols are "From within the root directory, libcblite-community-3.0.0, deploy" (multiple locations) -> libcblite-community -> libcblite "Direct access from Swift to Couchbase Lite for C is not possible in this 3.0.0 (beta) release." -> 3.0.0 not 3.0.0 (beta) " Drag libcblite.3.dylib into your Xcode project, within the dialog" -> not 100% sure this works, might need to be libcblite.3.0.0.dylib, as libcblite.3.dylib is a symlink "Within Android Studio , select and open the project folder (within the libcblite-community-3.0.0 or libcblite-3.0.0 folder)" -> both are libcblite-3.0.0 inside "Once the install is finished, you can build and run this skeleton app." -> what skeleton app? homebrew installation will also be available shortly after GA, and so those instructions ( brew install libcblite and brew install libcblite-community should be included. The table split between Debian 9 and 9 Desktop is still confusing to me, even 20.04 Desktop vs Core I don't think is needed.  I think grouping the versions together so just, for example, Debian 9 shows all three architectures would be fine.  Also Ubuntu 20.04 is missing arm32.  iOS is also missing x86 and arm32. As for the download links, the link text for Windows symbols is "macos" on both CE and EE and there are no symbols packages for debs, only for the tarballs (i.e. couchbase-lite-c-enterprise-3.0.0-debian10-x86_64.tar.gz has one but libcblite-dev-enterprise_3.0.0-debian10_amd64.deb does not).
          Ian.bridge Ian Bridge added a comment -

          All good. Thanks for the help Jim Borden 

          Ian.bridge Ian Bridge added a comment - All good. Thanks for the help Jim Borden  

          People

            Ian.bridge Ian Bridge
            jimb Jim Borden
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:

              Gerrit Reviews

                There are no open Gerrit changes

                PagerDuty