Page Contents

Overview

Bintray provides several options to promote your material, for example:

  • Including your packages in a central repository. A central repository is a large repository managed by the Bintray team, that includes sources from many contributing users, each of which retains full rights and total control over his or her material. At the same time, the material from each contributor receives the wide exposure that comes with the association to a central repository.

  • Linking a package to another user’s repository. A package that belongs to one repository may be linked and displayed as if it also belongs to another repository. This means that your package will be downloaded, visible in search results, and promoted just as much as the repository to which it is linked (in addition to, not instead of, the repository to which it actually belongs). This is one more option Bintray provides for cooperation between developers.

  • Interfacing with Twitter so that you can easily tweet the release of a new version in Bintray directly from the Bintray UI.

Note: These are only the promotion options that are most directly related to uploading. Most of the promotion of your material will be done by interacting with other users (this may include communicating with other users, working with Bintray organizations and other options of interacting).

Including your Package in JCenter

Including your package in a central repository carries the advantage of having your package exposed to a larger and more relevant audience, while retaining full rights to and total control of all your material. The main central repository available on Bintray is JCenter.

You may include your packages in JCenter if they are Maven packages.

Including your package in JCenter, Bintray’s Maven repository, is a simple and beneficial process. It carries simple and specific requirements and is easily performed via the Bintray UI.

Even when your package is included in JCenter, it is still your package. This means that you manage, modify and update the package as you would any other of your packages on Bintray. You manage the package through your own repositories on Bintray. Any modification will be updated automatically and will be available to the users accessing your package via the JCenter.

Before you can include your package in JCenter, the following requirements must be met:

  • The package must be in a Maven repository and must contain Maven sources.

  • The path of the files (entered in the Upload Files form of the Version page) must conform to Maven standards (the Group ID and Artifact ID combination must be unique, etc.; for more information about Maven standards, consult the appropriate Maven documentation)

  • Every version within the package that includes files must also include a valid POM file.

To include your package in JCenter:

  1. Access the Package page of the package you want to include in JCenter (you must be the owner of the package)

  2. In the lower right corner, in the section Included In, click the Add to JCenter button.

    Add to JCenter button (Pckg)

    The Compose Message page opens, with the addressee and subject already assigned for the request message.

    Compose msg: request inc. JCenter

  3. In the Compose Message page, you can:

    • Check the Host My Snapshot build artifacts checkbox to include your Maven snapshots in Bintray (click here for more information).

    • You can also add some text to the message - a few lines about what your package is and why it is relevant for JCenter (optional).

  4. Click Send.

    The request message is sent to the Bintray team, who assign your package a path in the relevant part of the tree structure of the JCenter repository.

    If the request is approved, an indication that the package is included in JCenter is displayed in the Package page, in the Included in work area in the bottom right corner of the page.
    Note: This same Included in work area also indicated repos to which the package has been linked.

    Your package is now exposed to all the users who visit the large, central repository of JCenter. You are still the owner and can update it.

Linking to Packages from External Sites

Bintray also enables you to create links to your packages by generating HTML code that you can embed directly on your own website. The Version Notification Link will help a user watch your package by taking him or her directly to Bintray where he/she can register to receive notifications whenever a new version of your package is uploaded. The Latest Version Download Badge will download the latest version of your package.

To Create a Version Notification Link:

  1. Access the relevant package page.

  2. Click the Version Notification Links button.

    A message displays three badges you can select to display on your website, along with the corresponding HTML code needed to embed them.

    Version Notification Link Options

  3. Select the badge you want to display and then click the Copy to Clipboard button to copy the corresponding HTML text to the clipboard.

  4. Paste the HTML code into the right place in your website source files.

To Create a Latest Version Download Badge:

  1. Access the relevant package page.

  2. Click the Latest Version Badge button.

    A message displays the code you need to embed in order to display the badge.

    Latest Version Download Badge

  3. The code is available in Markdown, AsciiDoc and HTML formats. Select the tab for the format you want and then click the Copy to Clipboard button to copy the corresponding code to the clipboard.

  4. Paste the code into the source file representing the place you want to display the badge.

Promoting Through External Accounts

To increase the reach of your software, Bintray lets you promote it through accounts you have with external providers such as Twitter, GitHub and Google.
Linking through external accounts

Promoting Through Twitter

When you create a new version, you may want to tweet about it. You can easily do this from inside the Bintray UI. All the information you need to include in the tweet is already in Bintray.

Note that you will need both a Twitter and Bintray account to do this.

Authorizing Bintray to Tweet

Before you can tweet through the Bintray UI, your Bintray account must be authorized in Twitter to have this access. Use the OAuth protocol to authorize Bintray to access your Twitter account. This process is initiated from Bintray but also requires signing in to Twitter. This process requires that you have a valid account in both Twitter and Bintray.

To authorize Bintray to access your Twitter account:

  1. Access your user profile and click the Edit button to display the Edit Your Profile page.

  2. In the General form, click the Accounts link.

  3. In the Accounts form, enter your Twitter username in the Twitter User field.

  4. Click the adjacent Link your Twitter account link.

    If you are already logged in to Twitter, then Bintray is automatically authorized to access your account, and you are returned to Bintray.

    If you are not logged in, Twitter displays a page asking you to sign in to authorize Bintray to use your account.
    Twitter: Sign in to authorize Bintray

  5. After signing in Bintray is authorized to access your Twitter account. You are returned to Bintray and a confirmation message is displayed.

    You can now begin tweeting from within the Bintray UI.

Tweeting About a New Version

Bintray also provides the option of tweeting about a new version of a package you own, as soon as you publish any file in that version. Ensure that you have authorized Bintray to access your Twitter account first.

To tweet about a new version:

  1. You can tweet about a version as soon as you publish any files in that version. The Tweet icon is located in the notice that appears immediately after you publish a file.
    Notice: published file (Twitter icon)

  2. In case you don’t manage to tweet before the notice is dismissed, you can also tweet at any time from the corresponding Version work area of that version’s Package page. Just click the Tweet icon.

    Twitter icon in Package page

    Note: The Tweet icon appears next to the newest version that has any published files (the published files themselves do not have to be the ones most recently published).
    The "Post a Tweet on Twitter" dialog box opens.

  3. If you are not logged in to your Twitter account, you will have to enter your Twitter username and password in order to log in as you tweet about your release.

  4. Bintray offers some default text with the version and a download link, but this is optional and can be changed.

  5. Click Sign in and Tweet (or just Tweet if you are already logged in to Twitter).
    If your tweet is successful, you will get a confirmation dialog from which you can click a View It on Twitter link to view your tweet.