Author Archives: Yodapollo

Android Publishing: Testing on an Android device

To help introduce our community to the world of Android publishing, we’ve prepared a series of Tutorials and Reference Guides for the Android Market. What follows is a part of that series, focusing on setting up your Android test device and installing the GameSalad Android Viewer.

Preparing the Device

On your Phone

  1. Settings > Manage Applications and check the box next to Unknown sources option
  2. After that go to Settings > SD Card > Phone Storage and uncheck the box next to USB storage.
  3. Finally you will need to go to Settings > Manage Applications > Development and check the box for USB Debugging
  4. Installing the Viewer on Device

    There are 2 ways to get the Viewer.apk on your device.

  1. Via email
  2. Via USB

Via Email:

You will need to have Gmail setup on the device you wish to install the Viewer on.

  1. Download the Viewer APK on your machine
  2. Email the APK to yourself through Gmail
  3. On your Android Phone, open the Gmail application
  4. When you view your mail message, there should be a link for you to install the APK
  5. Click the install button

Via USB:

  1. Connect your Android Phone to your system
  2. Open a Terminal
  3. To Verify if your device is registered with the Android Debug Bridge (ADB)
    • a. adb devices
  4. To install the viewer to the device
    • a. dab install path/file.apk
    • b. Where path is the full path from ~ to your apk and file.apk is the actual filename of the viewer apk

If you have problems running these commands the most likely issue is that they were not properly registered with your path variables (see steps above).

If they continue to not function you may wish to execute these commands via the Terminal directly from the Android SDK/platform-tools folder, ~/sdk/[android sdk folder]/platform-tools/ , if you chose the recommended folder setup from above. You will also need to preface each command with ./ in order to tell your system that the commands you wish to execute are in the current folder.

Previewing the Project from Creator on Device

Viewer for Android can communicate with your device both by USB and Wi-Fi.

Via USB:

  1. Plug in your device
    • a. Make sure that the device is set to charge only and does not mount the SD Card
  2. Launch Creator and open your Project
  3. Go to GameSalad > Preferences
  4. For the Android Device Bridge choose Select and browse to the [sdk]/platform-tools folder find the dab binary and accept
  5. Click on the Preview on Android
  6. Select your device from the dropdown
  7. ENJOY!!

Via Wi-Fi:

  1. Start GameSalad Creator on your system
  2. Ensure that your Android device and system are on the same wireless network
  3. Start GameSalad Viewer
  4. A Preview on Android icon will appear in GameSalad.
  5. Click it and select the name of your Android Device
  6. ENJOY!!

Android Publishing: Targeting Android Devices

To help introduce our community to the world of Android publishing, we’ve prepared a series of Tutorials and Reference Guides for the Android Market. What follows is part of that series, focusing on the publishing flow for Android targets within GameSalad Creator.

Publishing

Select Android as the target platform after clicking on Publish
Choose either Create New Game or Update

Overview

  • Set Category
  • Select “Choose File” and browse for a 512×512 .png image to use as your icon on Device
  • Enter in a Title for the Project
  • Enter in a Description
  • Enter in Keywords
  • Select Next

Platform

  • Enter in a Display Name for the Project
  • Enter in a Publicly Visible Version for the Project that will be displayed on the stores as the version for your application
  • Enter in an Android Version – This is a whole number that will be used in the background for determining updates to your application
  • Example: When you launch your original the Android Version will be 1. If you choose later to update, then during publish you will change this number to 2, so that once it is uploaded to the store anyone with the application will be notified of the update and the application will update over the older version as opposed to requiring the user to uninstall and install the new version.
  • Select Configure for Android Settings
  • Android Settings

    • Enter in an Android Package Name – This is a name that will be used on the backend to identify your application.
    • Enable Accelerometer, if your game makes use of this Feature
    • If you have a Keystore:
    • Under Application Signing, Select Keystore
    • In the newly visible Password Field, enter in the password for the Keystore
    • In the newly visible Alias dropdown, select the desired Alias for signing
    • In the newly visible password field under Alias, enter in the password for the Alias
  • If you do not have a Keystore
    • Under Application signing, select Generate Keystore
    • See the appendix for how to generate a Keystore or follow the instructions on the Android Developer Website
  • Verify the Keytool Location is valid – If the location is not showing as valid then browse to the proper location
  • Verify the Jarsigner Location is valid – If the location is not showing as valid then browse to the proper location
  • Verify the Zipalign Location is valid – If the location is not showing as valid then browse to the proper location
  • Select Done to return to the Platform page
  • Select Next to progress to the Video Page
  • Video

    • Enter in a URL to the desired YouTube video
    • Select Enter
    • Select Next to progress to the Review Page

    Screenshots

    • Drag and Drop the desired images from the bottom Pane into the Screenshots panels
    • Select Next to progress to the Review Page

    Review

    • Verify that all of the data is correct based on the previous choices
    • Select Publish
    • Read the GameSalad Terms and Agreements and then select Agree and Upload to start the final publish

    Publish and Save

    You will be presented with the following screens during the upload process:

    • Uploading Game Project
    • Upload complete, receiving app
    • Signing app package

    If everything was configured correctly during the previous setup screens you will be shown a save successful screen that will have an unsigned and signed version of your package. (See the appendix for the differences between a signed and unsigned apk)

    Android App Store Primer: Google and Amazon

    To help introduce our community to the world of Android publishing, we’ve prepared a series of Tutorials and Reference Guides for the Android Market. What follows is part of that series, focusing on the Google’s Android Market and Amazon’s App Store.

    Android Market

    About Android Market

    Android Market is a service that makes it easy for users to find and download Android applications to their Android-powered devices, either from the Android Market application on their device or from the Android Market web site (market.android.com). As a developer, you can use Android Market to distribute your applications to users on all types of Android-powered devices, all around the world.

    To publish your application on Android Market, you first need to register with the service using a Google account and agree to the terms of service. Once you are registered, you can upload your application to the service whenever you want, update it as many times as you want, and then publish it when you are ready. Once published, users can see your application, download it, and rate it.

    To register as an Android Market developer and get started with publishing, visit the Android Market publisher site:

    http://market.android.com/publish

    If you plan to publish your application on Android Market, you must make sure that it meets the requirements listed below, which are enforced by the Market server when you upload the application.

    Requirements enforced by the Android Market server:

    1. Your application must be signed with a cryptographic private key whose validity period ends after 22 October 2033.
    2. Your application must define both an android:versionCode and an android:versionName attribute in the “manifest” element of its manifest file. The server uses the android:versionCode as the basis for identifying the application internally and handling updates, and it displays the android:versionName to users as the application’s version.
    3. Your application must define both an android:icon and an android:label attribute in the “application” element of its manifest file.

    The final 2 points are handled with the Android Configure setting during Publish time.

    Publishing Updates on Android Market

    At any time after publishing an application on Android Market, you can upload and publish an update to the same application package. When you publish an update to an application, users who have already installed the application may receive a notification that an update is available for the application. They can then choose to update the application to the latest version.

    Before uploading the updated application, be sure that you have incremented the Version Code and Version Name attributes when re-publishing. Also, the package name must be the same as the existing version and the .apk file must be signed with the same private key. If the package name and signing certificate do not match those of the existing version, Market will consider it a new application, publish it as such, and will not offer it to existing users as an update.

    Using Android Market Licensing Service

    Android Market offers a licensing service that lets you enforce licensing policies for paid applications that you publish through Android Market. With Android Market Licensing, your applications can query Android Market at runtime to obtain the licensing status for the current user, then allow or disallow further use of the application as appropriate. Using the service, you can apply a flexible licensing policy on an application-by-application basis—each application can enforce its licensing status in the way most appropriate for it.

    Any application that you publish through Android Market can use the Android Market Licensing Service. The service uses no dedicated framework APIs, so you can add licensing to any application that uses a minimum API Level of 3 or higher.

    For complete information about Android Market Licensing Service and how to use it in your application, read Application Licensing.

    Uploading Your App to the Android Market

    1. Launch your web browser, navigate to http://market.android.com/publish/ and sign in with your Google Account.
    2. If you aren’t forwarded automatically after logging in, navigate to http://market.android.com/publish/Home and click the “Upload Application” button
    3. Click the “Choose File” button next to “Application .apk file”, browse to Kilo.apkon your hard drive, and click the the “Upload” button.
    4. You can optionally upload a couple of screenshots to be displayed on the Market page for your app.
    5. Enter a title for your app in the Listing Details section (30 characters max).
    6. Enter a description for your app (325 characters max).
    7. Select a type and category for your app.
    8. Specify a price for your app.
    9. Indicate your copy protection and location preferences in the Publishing Options section.
    10. Enter your website, email, and phone number in the Contact Information section.
    11. Agree to the terms in the Consent section.
    12. Click the Publish button.

    Congrats! Your app will be available in the Android Market almost immediately.

    Amazon Market

    About the Amazon Market

    The Amazon Appstore Developer Program enables mobile application developers to sell their apps on Amazon.com. By joining the program, you are able to market your apps to tens of millions of Amazon customers using Amazon’s proven marketing features and manage your apps using convenient self-service account management tools.

    Approval Process and Content Guidelines

    The minimum assets required for submission are:

    • a small icon
    • a thumbnail (a larger version of the icon)
    • a minimum of three screenshots that accurately depict your application

    When you submit an app in the Developer Portal, the Amazon Appstore team will start the app review process. You can track the approval status of your app at any time by logging into the Developer Portal and finding your app in the “Dashboard” on the portal home page. If there are any questions about your app during the review process or determine it does not meet one of the Amazon Appstore’s acceptance criteria, we will notify you using the email address associated with your account and provide guidance on next steps. They will also notify you once your app successfully completes the testing process. At that point, your app will be published and ready for merchandising.

    Each app that you submit to us must adhere to the following Content Guidelines (from the amazon website)

    • Offensive Content: What we deem offensive is probably about what you would expect. We reserve the right to determine the appropriateness of all apps and to accept or reject any app at our discretion. We also have full discretion to publish maturity ratings for the apps.
    • Pornography: We prohibit apps containing pornography or hard-core material that depict graphic sexual acts or sexually explicit material. We also don’t allow content that drives traffic to pornography sites.
    • Illegal Activity: Each app must comply with all applicable laws. We prohibit apps that promote or may lead to the production of an illegal item or illegal activity. Developers are responsible for researching to ensure that each app is in compliance with all local, state, national, and international laws.
    • Intellectual Property Infringement: We prohibit any app to which you do not have the necessary rights to make a
    • Privacy/Publicity Infringement: We hold personal privacy in the highest regard. Therefore, we prohibit apps that infringe, or have the potential to infringe, upon an individual’s privacy, right of publicity, or that portray an individual in a false light. Celebrity images and/or celebrity names cannot be used for commercial purposes without permission of the celebrity or their management. This includes unauthorized celebrity image collections.
    • Copyright Policy: Amazon’s Appstore Distribution Agreement requires that you have ownership or license rights to the code and content (including advertising) included in any app. Do not upload any app if you do not have the rights listed in the Appstore Distribution Agreement. You are responsible for ensuring that you hold necessary rights to distribute the app through the Amazon Appstore. If you are unsure if you own all rights to the app, please consult an attorney.

    Creating an Account and Submitting Apps

    1. Click on the link and register for an Amazon account: https://developer.amazon.com/welcome.html
    2. Type in your E-mail address and select “I am a new customer” and click on “Sign in using secure server”.
      • Note: You can login through your previous Amazon account if you have any.

    3. Fill the required fields and click “create account”.
      • You will see a welcome screen and click on “Get Started”.

    4. Fill in your detailed account information.
    5. Accept License Agreement.
    6. Pay registration fee as applicable.
    7. Select type of your apps (free/paid) and finally click “Save”.
    8. Now you have successfully created your developer account. In your home screen click on “Add New App”.
    9. Fill in appropriate details about your app.
    10. Fill in the content ratings.
    11. Upload multimedia for promotional purposes.
    12. Finally upload your .apk file under “Upload Binary” and click “Submit app”.

    GameSalad 0.9.85: Android Publishing is here!

    Over this past year, we’ve made strides to bring GameSalad games to more platforms. This past summer, we debuted our first non-Apple publishing target, with our HTML5-powered GameSalad Arcade. Today, GameSalad is pleased to announce its newest platform target and Professional feature: Android publishing, available today in GameSalad 0.9.85 Beta.

    The Android market is far more varied and complex than the world of iOS publishing, with a multitude of Android app stores and almost innumerable devices with varied resolutions and device specifications. To accommodate this expansive market, our engineers have crafted our Android publishing system to support all the major markets, including Google, and Amazon, as well as all the latest and greatest Android devices like the Nook Color, the Samsung Galaxy Tab, and the soon to launch Amazon Kindle Fire.

    As mentioned earlier, Android publishing is being introduced as a Professional feature. Setting up the development environment, and managing multiple forms of app packages, both signed and unsigned, as well as the multitude of app stores make for a very complex and sometimes overwhelming market. We believe Professional GameSalad members have an incredible opportunity to establish themselves on the Android marketplace, and will be a perfect group to break ground for the GameSalad community.

    Also, like we said before, the Android world is very big place. To help orient yourself, we’ll be providing a primer to Android App Stores and Android Devices. This will help provide you with all the need to knows in terms of testing games on comparable devices, and understanding the various package requirements that can vary from marketplace to marketplace.

    That being said, Android publishing isn’t the only thing new in Creator 0.9.85. We’ve also made modifications for improving compatibility with iOS 5. Also, we’ve implemented some expanded functionality in the OpenURL behavior, now allowing users to select between our in-app browser and mobile Safari. The behavior will now also automatically detect iOS App Store or email links and open the proper application (App Store or Email) rather than utilizing a browser first.

    This is just the beginning and we’ve got a lot more coming very soon, including the second half of our performance / loading improvements, tables support, Game Center achievements, and in-app purchase.

    Thank you to everyone in the GameSalad community for the incredible games you’ve been producing over the last two years and we can’t wait to see what you bring to the Android marketplace.

    Where to go now: