chapter 9 - submit your app - API Software, Inc

miststizzaMobile - Wireless

Dec 10, 2013 (3 years and 7 months ago)

65 views

PUBLISH


THE FINAL FRONTIER

Aka: PUBLISH
YOUR APP

-

GET A PHONE

By:

S. Fla Windows 8 Developers Group


Contents

CHAPTER 1
-

LIST OF SOFTWARE YOU WILL (or might) NEED

................................
................................
.......

2

CHAPTER 2
-

LIST OF MATERIALS FOR A SUCCESSFUL UPLOAD

................................
................................
....

4

CHAPTER 3
-

CREATE THE VISUAL STUDIO PROJECT

................................
................................
.....................

5

CHAPTER 4


TESTING ON A DEVICE TO EARN A TOKEN

................................
................................
..............

9

CHAPTER 5
-

CREATE A NOKIA ACCOUNT

................................
................................
................................
...

10

CHAPTER 6
-

USE YOUR TOKEN

................................
................................
................................
...................

12

CHAPTER 7
-

GET WINDOWS STORE TOKEN

................................
................................
...............................

15

CHAPTER 8
-

USE WINDOWS STORE TOKEN TO GET A STORE ACCOUNT

................................
...................

16

CHAPTER 9
-

SUBMIT YOUR APP

................................
................................
................................
.................

20

CHAPTER 10
-

GET YOUR GUID FOR NOKIA

................................
................................
................................

26

CHAPTER 11
-

TO GET YOUR NEW PHONE FROM NOKIA

................................
................................
...........

27

APPENDIX
-

OTHER COOL STUFF TO DO

................................
................................
................................
.....

30


PREFACE:

This project will get you a phone if you get your app submitted and approved before
the promo runs
out. Right now, it is AT LEAST until the end of Sept 2013. We will get you free access to the Windows
Store (thanks to Bill Reiss, our Nokia Ambassador).

If you are a STUDENT, you can get a DreamSpark account and it will have a promo code
to use for the
Windows Store. You can skip to chapters 4
-
7. If you have a BizSpark account, you can also skip these
steps.

For everyone else (or for anyone interested), we will get you Nokia tokens that award you:

1.

Windows Store Tokens

2.

License to Telerik
phone controls

3.

Usage of a cloud
-
based storage system (Buddy)

Upon successful and timely completion of app submission, Nokia will send you a Lumia 800.

This event
and document is c
ourtesy of: The S. Fla Windows 8 Developers Group

Organizers: Frank Haggar

and Colt Taylor

EVENT SPONSORS: NOKIA and MICROSOFT


CHAPTER 1
-

LIST OF SOFTWARE YOU WILL (or might) NEED


To get the most out of this meeting, you will want to bring a laptop with the following free software
installed. If you
have trouble installing any of this software, bring the laptop anyway and we will assist
you in loading the software before we start.


1.

PC or LAPTOP
RUNNING WINDOWS 8
!!!


2.

Visual Studio 2012 for Phone. You can use the free Express Edition. Get the Windows
8 Phone
SDK and it will automatically install the separate EXPRESS EDITION if you need it.


http://www.microsoft.com/visualstudio/eng/products/visual
-
studio
-
express
-
for
-
windows
-
phone


3.

Image editor to create the icons

a.

PAINT will work, it’s free and comes with your PC

b.

GIMP is free and can be used


4.

OPTIONAL SOFTWARE:

a.

CONSTRUCT 2 to easily generate the VISUAL STUDIO stuff

http://www.scirra.com/

b.

GAME MAKER if you prefer it and know how to use it

c.

Sound Editor (audacity is free), if you want sounds in your app


5.

Willingness to make a very simple app so we can learn about store submission

a.

We make the app full screen so
we don’t have too much WIN8 standards to deal with

b.

We make the app do something amusing, like ring a doorbell, ring a phone, etc

Using Construct
2.0

and the application templates which we will provide,

you will create an extremely simple app and export it
as a Windows Phone 8 project.

Most of the apps we will be creating are simple “click to play a sound” toys.

A classic example of this kind of app is the “Goat Scream” app which starts with

a picture of a goat on the screen and when you touch it, a goat's b
aying scream

plays. Not a very difficult coding challenge, especially with Construct
2.0

doing

all the work, but this meeting is about publishing, not coding.


If you want to personalize this project to fit your signature style, bring a personally

owned o
r public domain image and some wav
-
formatted sound files. If these files

need scaling, cropping or resampling to make them usable, bring them anyway and

the organizers will help you edit them appropriately.



SIMPLE APP
IDEAS


Doorbell Sound


Phone Ringin
g Sound


Typing sound


Snoring Sound


Animal Sounds (cat, dog, duck, cow, horse, pig)


Bell sound


Horn Sound


Silencer Bullet sound


(etc)


OTHER RESOURCES:

Search YouTube for:

LANCE MCCARTHY NOKIA

A video of how to redeem a Nokia premium token is posted
there.


PLACES TO GET CLIPART, SOUNDS, IMAGES, ETC:

http://www.freesound.org

http://www.openclipart.org


Search:
http://dfwiki.devfish.net/

Find this:
http://dfwiki.devfish.net/technology.Icons.ashx

To dig in and find this:

http://www.dotgovwatch.com/?/archives/8
-
The
-
Best
-
Copyright
-
Free
-
Photo
-
Libraries.html





CHAPTER 2
-

LIST OF MATERIALS FOR A SUCCESSFUL UPLOAD

To upload to the store, you will need:

1.

A Windows LIVE account.

If you don't already have on
e, create a Live ID. Or, you can create a new one here:

http://signup.live.com



If you have Hotmail.com, outlook.com or live.com email account, that IS a Live
account



if you have XBOX LIVE or Messenger then use the
email associated with that tag



You can create a new @hotmail, @outlook, o @live email if you want



You can turn any standard email account into your LIVE login (see the signup link
above)

2.

A XAP file

a.

It must be compiled for release (not debug)

b.

It must
contain an icon (100x100)

c.

It must contain a FLIP TILE (159x159)

d.

It must contain a MEDIUM FLIP TILE (336x336)

e.

If it is a game, it should have the MANIFEST edited (via XML) and change the genre
from apps.normal to apps.game


3.

A store icon, 300X300. Make this
when you make the others.


4.

A store image


a.

Either an image that is 800x1280 or

b.

a screen grab from the emulator in WXGA resolution (the WinStore system will
create all the other resolutions for you).


This is done by:

i.

Build the app

ii.

Set the emulator to WXG
A.

iii.

Select RUN WITHOUT DEBUG from the DEBUG pulldown

iv.

Click the >> arrows to expand the emulator

v.

Click on CAPTURE.

vi.

SAVE it to the hard disk.



CHAPTER 3
-

CREATE THE VISUAL STUDIO PROJECT

The goal here is to make an .XAP file and test it on a phone.

Let’s assume you will have to use Visual Studio to compile the code.

How do you get the
program
code

needed to create the XAP file
?



You can write a native app.



You can use CONSTRUCT 2, GameMaker, etc to generate an app



You can use APP STUDIO to generate
an app



You can use PhoneGap



Etc, etc


Note: See the accompanying document on how to create an app with CONSTRUCT 2.

Using the Project Properties
screen in Visual Studio 2012 Express for Windows Phone (or Construct 2),
you will fill in your personal informa
tion as the author and a brief description of the application. At this
point you will also create or find the icons for your application and load them into their respective places
on the properties screen.

Using Visual Studio 2012 Express for Windows Phon
e, you will compile your app, creating a submittable
package out of your code and images. Th
is stage may or may not involve

testing and debugging,
depending on whether your laptop supports processor
-
level virtualization which is needed to run the
phone si
mulator.

Make sure you’ve done the following:

1.

Change the BUILD MODE to RELEASE under BUILD menu/Configuration Manager



2.

If you used CONSTRUCT 2

to generate your code, you need to edit

your icons
. If not, you may
need to create them.

a.

Go to the SOLUTIONS
EXPLORER

b.

CLICK on ASSETS

c.

Edit (or replace) the ApplicationIcon
. This icon is 100x100



d.

Open the TILES and edit/replace the SMALL

(159x159)

and MEDIUM

(336x336)

flip tiles





3.

If you did NOT use CONSTRUCT 2, add your icon items in to the project. Specify

them on the
MANIFEST
screen.


4.

In EITHER case, edit the MANIFEST screen to verify they are set up properly




5.

Double
-
click shows manifest screen



Scroll down and make sure your icons appear.

a.

The APP Icon (100x10)

b.

The tile icons (you only need 2, the 1
59x159 and 336x336)


6.

If you have a GAME, you need to edit the XML of the manifest:



The code window will appear:



Find the GENRE tag and change “apps.normal” to “apps.game”

THIS IS ONLY IF YOU HAVE A GAME and want it to appear properly with other
games on the phone!

CHAPTER 4


TESTING ON A DEVICE TO EARN A TOKEN

To earn a token from Nokia, you will need to test on a device and show the operation to a Nokia Rep. To
allow your device to run the app, you must use the WINDOWS 8 SDK to enable it. Sea
rch BING/GOOGLE
for instructions.

At this event, there will be Microsoft/Nokia folks that have phones to test on, so you need not worry
about side
-
loading yours with your app.

1.

Plug the device into the PC with a USB cable

2.

Select DEVICE from the simulator
options


3.

Click RUN (the green arrow head) to launch the app.

4.

Once it runs, you can test it. Show the Nokia rep.

5.

As a part of this test, go to SETTINGS and hold down on the icon. A menu will appear. Select
PIN TO START.

6.

Go to the START MENU
and find the app. It should have a nice icon.

7.

Hold down on the icon. Small arrow will appear to shrink or grow the icon. Try this to make
sure it looks good at all available tile sizes

8.

Ask the Nokia rep for your token so you can use it in STEP 6. You

will need:

a.

Your Name

b.

Your Email




H

E

R

e

CHAPTER 5

-

CREATE A NOKIA ACCOUNT

STEP 1: Create a nokia developer account by JOINING.



Click JOIN:



Once this is filled, click SUBMIT

Here

Here


Fill out the remaining details, click SUBMIT




Here

CHAPTER 6

-

USE YOUR TOKEN

Go to:

https://developer.nokia.com/token

/YOURTOKEN


1.


Make sure it is HTTPS not HTTP

2.

Replace “YOURTOKEN” with the token we provided

3.

Finish filling out the screen.




Continue filling forms until:

Individal






Click CONTINUE


Agree

Click


YOU NOW HAVE WINDOWS STORE TOKENS, AND TELERIK TOKENS!



Click Here

CHAPTER 7

-

GET WINDOWS STORE TOKEN

Click REQUEST TOKENS on
the VERY RIGHT panel


Click on
WINDOWS PHONE STORE



Token Here

Copy this somewhere safe


CHAPTER 8

-

USE WINDOWS STORE TOKEN TO GET A STORE ACCOUNT

IN A SEPARATE TAB… GO TO HERE:

http://dev.windowsphone.com/en
-
us



SEE THIS:


Click Sign In with your WINDOWS LIVE account

(if you don’t have one, you can create one OR turn any
email account into one at
https://signup.live.com
.. Note that any HOTMAIL, LIVE.COM or
OUTLOOK.COM accou
nt is one. If you have XBOX LIVE, that email is also a LIVE account.)

Go Here

S
i
g
n

i
n


CLICK ON “SUBMIT APP”



THIS LEADS TO MORE TO FILL OUT!!

C
L
I
C
K

Join


CHOOSE INDIVIDUAL above, because CORPORATE is COMPLEX and requires additional validation.


Keep Filling…. But your WINDOWS LIVE account will pre
-
fill most of it for you. Click NEXT.



Enter Code from Nokia’s page (ON THE OTHER TAB)

INDIVIDUAL!

Paste or type long token/code from Nokia


Scroll down (DO NOT SET UP ANYTHING ELSE)




Click DONE!

You should get an EMAIL. You will need to
confirm the email.

Click

CHAPTER 9
-

SUBMIT YOUR APP

Click on SUBMIT APP again. This time, the screen is different.


Click on [1]


Here, you give your app a name.

For a
pps that “make noise”, put them in the App Category of Entertainment. Games go into Games.

Start app submission

Unique name for app


Other prompts on the page let you set a price and region. Leave these as
-
is for this project and save the
defaults.

Click SAVE and
the following screen appears:



Click on [2]

Leave the rest. Click Save

Time to upload .XAP


Click on Add New to be able to upload a new app



Click Here

Browse

Pick the .XAP file from your project’s
\
BIN
\
RELEASE folder. The following screen will appear:



Scroll down:


Scroll further...


Enter a description of your project. Enter keywords people can use to SEARCH and find your app.

Then, scroll further down



1.

Click on the small [+] to upload the 300x300 store
icon
image for your app
. Upload that picture.

2.

Click on the first [+] in the group of 8 screenshots to upload your screen image.

Type Search Words

You need this

And one of these (WXGA)


It should look like this.


Scroll down and hit SAVE.



Now
review and submit.

We are done

CHAPTER 10
-

GET YOUR GUID FOR NOKIA

To get the phone, Nokia will need to email the following to Bill Reiss:



Publisher Name



GUID



CITY



STATE



Your Name



Your Email


Here’s how you get these:


GUID. Click on Account and Account Summary



Send an email to Bill Reiss (
billreiss@outlook.com
) with:



Publisher Name



Publisher GUID



Your Name



Your Email



Your City



Your State

Name

GUID

CHAPTER 11
-

TO GET YOUR NEW PHONE FROM NOKIA

Bill Reiss will then

email you and ask for the following, once your app is actually through certification:

Your Address

The link to the item once it’s in the store.


Here’s how to get the link to the store, once Microsoft sends you an email.

Click on APPS


Click on the app
name



Click on DETAILS




D
e
t
a
i
l
s

Scroll down to see the link:



Cut/paste that and send to Bill Reiss.




Link to store

APPENDIX
-

OTHER COOL STUFF TO DO




Join
www.Dvlup.com

(Nokia’s rewards site for people that publish apps).



Twitter Follow...

o

Devfish (@devfish)

o

jim quick

(@jquickwit)

o

bill reiss (@billreiss)

o

frank haggar (@fhaggar)



Join
fla
-
windev@live.com




Join the S. Fla Window
s Developers Meetup group!!



Thank your sponsors/hosts (Microsoft & Nokia)



PUBLISH A SECOND APP WITHIN 1 MONTH!!