The Android Buy SDK allows developers to integrate Shopify stores into their Android apps. It uses GraphQL to retrieve product, collection, and customer data from a Shopify store and supports features like searching, filtering, checkout, and Android Pay integration. Developers can authenticate with the SDK using their Shopify API key, define GraphQL queries to fetch store data, process checkouts including web and Android Pay options, and handle customer account creation and login.

2. What is the Android Buy SDK?

7. What's new with the Android Buy
SDK?

8. GraphQL?

10. In the olden days of REST
! GET h&ps://joshubrown.myshopify.com/collec:ons.json
! GET h&ps://joshubrown.myshopify.com/products.json
! GET h&ps://joshubrown.myshopify.com/meta.json

11. Before you build

12. Crea%ng the mobile buy channel in
Shopify
Free ! stores: developers.shopify.com

17. Grade build dependencies
compile 'com.shopify.mobilebuysdk:buy3:3.0.0'
compile 'com.shopify.mobilebuysdk:buy3-pay-support:1.0.0'

18. Se#ng up GraphClient
GraphClient graphClient = GraphClient.builder(this)
.shopDomain(BuildConfig.SHOP_DOMAIN)
.accessToken(BuildConfig.API_KEY)
.build();

19. Defining a query
Storefront.QueryRootQuery query = Storefront.query(new Storefront.QueryRootQueryDefinition() {
@Override
public void define(final Storefront.QueryRootQuery rootQueryBuilder) {
rootQueryBuilder.shop(new Storefront.ShopQueryDefinition() {
@Override
public void define(final Storefront.ShopQuery shopQueryBuilder) {
shopQueryBuilder.privacyPolicy(new Storefront.ShopPolicyQueryDefinition() {
@Override
public void define(final Storefront.ShopPolicyQuery policyQueryBuilder) {
policyQueryBuilder.body();
policyQueryBuilder.url();
}
});
}
});
}
});

20. Defining a query with Lambda expressions
Storefront.QueryRootQuery query = Storefront.query(rootQuery -> rootQuery
.shop(shopQuery -> shopQuery
.privacyPolicy(policyQuery -> policyQuery
.body()
.url()
)
)
);

21. Log.v(TAG, query.toString());
{
shop {
privacyPolicy {
id
body
url
}
}
}

22. QueryGraphCall call = graphClient.queryGraph(query);
call.enqueue(new GraphCall.Callback<Storefront.QueryRoot>() {
@Override
public void onResponse(@NonNull GraphResponse<Storefront.QueryRoot> response) {
String body = response.data().getShop().getPrivacyPolicy().getBody();
String url = response.data().getShop().getPrivacyPolicy().getUrl();
}
@Override
public void onFailure(@NonNull GraphError error) {
Log.e("db", "Failed to execute query" + error.toString());
}
});

23. Retrieving product and collec1ons
data

25. Storefront.QueryRootQuery query = Storefront.query(rootQuery -> rootQuery
.shop(shopQuery -> shopQuery
.collections(10, collectionConnectionQuery -> collectionConnectionQuery
.edges(collectionEdgeQuery -> collectionEdgeQuery
.node(collectionQuery -> collectionQuery
.title()
.products(10, productConnectionQuery -> productConnectionQuery
.edges(productEdgeQuery -> productEdgeQuery
.node(productQuery -> productQuery
.title()
.productType()
.description()
)
)
)
)
)
)
)
);

26. Search !
Storefront.QueryRootQuery query = Storefront.query(root -> root
.shop(shop -> shop
.products(10, arg -> arg.query("lime"), connection -> connection
.edges(edges -> edges
.node(node -> node
.title()
)
)
)
)
);

27. !
• Fuzzy match on all fields of the resource: burger
• On a specific field: title:"Bacon burger"
• Nega;ve matches: -title:"Plate of tomatoes"
• Combina;ons: (product_type:"drink" AND
title:Tea)

28. Adding customer signup
Storefront.CustomerCreateInput customer = new Storefront.CustomerCreateInput("test", "test")
.setEmail("josh.brown@shopify.com")
.setFirstName("Josh")
.setLastName("Brown")
.setPassword("verysecret")
.setAcceptsMarketing(true);
Storefront.MutationQuery query = Storefront.mutation(rootQuery -> rootQuery
.customerCreate(customer, createCustomer -> createCustomer
.customer(customerQuery -> customerQuery
.firstName()
.id()
)
.userErrors(userErrorQuery -> userErrorQuery
.field()
.message()
)
)
);

29. graphClient.mutateGraph(query).enqueue(new GraphCall.Callback<Storefront.Mutation>() {
@Override
public void onResponse(@NonNull GraphResponse<Storefront.Mutation> response) {
if (!response.data().getCustomerCreate().getUserErrors().isEmpty()) {
for (Storefront.UserError error: response.data().getCustomerCreate().getUserErrors()
) {
Log.v(TAG, error.getMessage());
}
}
Storefront.Customer customer = response.data().getCustomerCreate().getCustomer();
Log.v(TAG, customer.getId().toString());
}
@Override
public void onFailure(GraphError error) {
// ...
}
});

30. Checkout op+ons
Web checkout !
Android Pay !

31. Web checkout

32. Storefront.CheckoutCreateInput input = new Storefront.CheckoutCreateInput()
.setLineItems(Arrays.asList(
new Storefront.CheckoutLineItemInput(new ID("AjsFwRr=="), 5),
new Storefront.CheckoutLineItemInput(new ID("JfEiTnD=="), 3)
));
Storefront.MutationQuery query = Storefront.mutation(mutationQuery -> mutationQuery
.checkoutCreate(input, createPayloadQuery -> createPayloadQuery
.checkout(checkoutQuery -> checkoutQuery
.webUrl()
)
.userErrors(userErrorQuery -> userErrorQuery
.field()
.message()
)
)
);

33. graphClient.mutateGraph(query).enqueue(new GraphCall.Callback<Storefront.Mutation>() {
@Override
public void onResponse(@NonNull GraphResponse<Storefront.Mutation> response) {
if (!response.data().getCheckoutCreate().getUserErrors().isEmpty()) {
for (Storefront.UserError error :
response.data().getCheckoutCreate().getUserErrors()) {
Log.v(TAG, error.getMessage());
}
} else {
Storefront.Checkout checkout = response.data().getCheckoutCreate().getCheckout();
Log.v(TAG, checkout.getWebUrl());
}
}
@Override
public void onFailure(@NonNull GraphError error) {
}
});

34. Android Pay
compile 'com.shopify.mobilebuysdk:buy3-pay-
support:1.0.0'

35. PayCart - building the Android Pay cart
PayCart payCart = PayCart.builder()
.merchantName(MERCHANT_NAME)
.currencyCode(shop.currency)
.shippingAddressRequired(checkout.requiresShipping)
.phoneNumberRequired(true)
.shipsToCountries(Arrays.asList("US", "CA"))
.addLineItem("Product1", 1, BigDecimal.valueOf(1.99))
.addLineItem("Product2", 10, BigDecimal.valueOf(3.99))
.subtotal(checkout.subtotalPrice)
.totalPrice(checkout.totalPrice)
.taxPrice(checkout.taxPrice)
.build();
PayHelper - interac/ons with Android Pay API

36. Resources