---
schema_version: "1"
id: d7bd2c6802d21ca4885f9912d9713f22854b320ae08e49e7198d0e91b056f903
title: Create a Binary Handoff Project for the Salesforce Mobile App
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/s1_branded_apps_create_bh_project.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.s1_branded_apps_create_bh_project.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 9ddfe979cd836a658dfa93f9334688f8492bb569664f9bcf7018b2b5ea2836fd
description: Use the binary handoff distribution method to have Salesforce build your app and provide you with the binary file (.ipa or .aab) for manual signing and distribution. This method is ideal for organizations with security protocols that require in-house code signing or specific internal distribution processes. Use the binary handoff distribution when you’re certain you don’t want to change the distribution method, because you can't change it to fully managed or binary upload.
products:
  - Mobile App
  - Cross Cloud
release: "264"
---
# Create a Binary Handoff Project for the Salesforce Mobile App

Use the binary handoff distribution method to have Salesforce build your app and provide you with the binary file (.ipa or .aab) for manual signing and distribution. This method is ideal for organizations with security protocols that require in-house code signing or specific internal distribution processes. Use the binary handoff distribution when you’re certain you don’t want to change the distribution method, because you can't change it to fully managed or binary upload.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col style="width:100%"></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Setup for Mobile Publisher available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Setup for Mobile Publisher available in: production only (not sandbox)</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in Lightning Experience in: <strong>Enterprise</strong>, <strong>Performance</strong>, and <strong>Unlimited</strong> Editions</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d5688e70">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d5688e70 ">To create and modify a Mobile Publisher project:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d5688e70 ">Manage mySalesforce Apps</td>
          </tr>
        </tbody>
      </table>

![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-mysalesforce-264-0-0-production-enus/a39debb4-ddcf-4d21-ae97-ca8229316d3a/images/icon_important.png)

Important After you request the app binary, the distribution method is locked to Binary Handoff and can’t be changed.

When you use Binary Handoff, Salesforce builds the application binary and delivers it to you, but your organization maintains full control over the signing identity and store submission.

1. From Setup, in the Quick Find box, enter Mobile Publisher, and then select Mobile Publisher.
2. Click Create New App.
3. Select **External Client App** and click **Next**.
4. Select **Salesforce App** as the app type and click **Next**.
5. Enter a project name and click **Next**.
    
    ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-mysalesforce-264-0-0-production-enus/a39debb4-ddcf-4d21-ae97-ca8229316d3a/images/icon_important.png)
    
    Important You can’t change the project name after you save it. The project name is only seen internally, not by the app users.
6. Click Start for the platform (iOS or Android) you want to configure.
7. In the Set Up the Mobile App section, click Start.
8. Click Change App Distribution Method, select Binary Handoff, and click Done.
9. ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-mysalesforce-264-0-0-production-enus/a39debb4-ddcf-4d21-ae97-ca8229316d3a/images/icon_important.png)
    
    Important For Android apps, register your app in Firebase using the Customer Store Identifier field in the Setup UI to obtain the google-services.json file. If your app uses deep links, supply the SHA-256 value in the setup form. You can find the value in your Google Play console, in **Test & Release** | **App Integrity** | **App Signing** | **Play App Signing** | **Settings**.
    
    Complete the Customer Store Identifier and all other required fields on the form.
10. Click Submit.
11. In the Set Up an External Client App section, click **Start** to configure and deploy your ECA to production.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-mysalesforce-264-0-0-production-enus/a39debb4-ddcf-4d21-ae97-ca8229316d3a/images/icon_note.png)
    
    Note To test your app in a sandbox, deploy the ECA to the sandbox org after deploying to production. During ECA setup, you can also turn on push notifications by adding your Apple APNs key (.p8 file) or Google Firebase Admin SDK JSON file.
12. From the main Mobile Publisher Setup page, click Request Binary. Salesforce builds the app binary and delivers it to you.

After receiving the binary, you're responsible for re-signing it with your own signing certificates and private keys and submitting it to the app stores.

- **[Set Up Environments for a Binary Handoff Project for the Salesforce Mobile App](https://help.salesforce.com/s/articleView?id=xcloud.s1_branded_apps_set_up_env.htm&release=264.0.0&type=5)**  
    Set up Apple and Google environments for binary handoff projects.