Appy builder beginner tutorial
- 2. Four Simple Tutorials for Getting Started with AppyBuilder 1 TalkToMe: Your first AppyBuilder app 03 2 TalkToMe Part 2: Shaking and User Input 21 3 BallBounce: A simple game app 31 4 DigitalDoodle: Drawing App 45 If you have any questions please visit http://Community.AppyBuilder.com This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License Based upon the tutorials from App Inventor available at http://appinventor.mit.edu/explore/ai2/beginner-videos.html AppyBuilder Beginner Tutorials - 1
- 3. Four Simple Tutorials for Getting Started with AppyBuilder AppyBuilder Beginner Tutorials - 2
- 4. TalkToMe: Your first AppyBuilder app This step-by-step picture tutorial will guide you through making a talking app. The app will first let your phone say sentences hardcoded in the app. Later on it will say sentences you enter in a Textbox. To get started, go to App Inventor on the web. Go directly to http://gold.appybuilder.com/, or click the "BUILD NOW!" button from the AppyBuilder website. AppyBuilder Beginner Tutorials - 3
- 5. Log in to AppyBuilder with a gmail (or google) user name and password. Use an existing gmail account or school-based google account to log in to the http://gold.appybuilder.com/ website. To set up a brand new gmail account, go to https://accounts.google.com/SignUp AppyBuilder Beginner Tutorials - 4
- 6. Start a new project. Name the project "TalkToMe" (no spaces!) Type in the project name (underscores are allowed, spaces are not) and click OK. AppyBuilder Beginner Tutorials - 5
- 7. You are now in the Designer, to lay out the "user interface". The Design Window, or simply "Designer" is where you lay out the look and feel of your app, and specify what functionalities it should have. You choose things for the user interface things like Buttons, Images, and Text boxes, and functionalities like Text-to-Speech, Sensors, and GPS. Add a Button Our project needs a button. Click and hold on the word "Button" in the palette. Drag your mouse over to the Viewer. Drag and Drop the Button component and a new button will appear on the Viewer. TIP: Components such as Button, Label are called visible components. These are type of components that can be seen on the screen and user can interact with. AppyBuilder Beginner Tutorials - 6
- 8. Connect AppyBuilder to your phone for live testing One of the neatest things about AppyBuilder is that you can see and test your app while you're building it, on a connected device. This feature is called “Live Testing”. If you have an Android phone or tablet, follow the steps below. AppyBuilder Beginner Tutorials - 7
- 9. Get the AppyBuilder Companion from Google Play and install it on your phone or tablet. The preferred method for getting the AppyBuilder Companion App is to download the app from Google Play by searching for "AppyBuilder Companion". AppyBuilder Beginner Tutorials - 8
- 10. To download the AppyBuilder Companion App to your device directly (SKIP THIS STEP IF YOU already got the app from Play Store) If for some reason you can not connect to the Google Play store, you can download the AppyBuilder Companion as described here. First, you will need to go into your phone's settings, choose "Security", then scroll down to allow "Unknown Sources", which allows apps that are not from the Play Store to be installed on the phone. Second, do one of the following: A. Scan the QR code below or B. Download the companion from http://AppyBuilder.com/companion/AppyBuilderGold.apk, to your computer and then move it over to your device to install it. AppyBuilder Beginner Tutorials - 9
- 11. Start the AppyBuilder Companion on your device On your phone or tablet, click the icon for the AppyBuilder Companion to start the app. NOTE: Your phone and computer must both be on the same wireless network. Make sure your phone's wifi is on and that you are connected to the local wireless network. If you can not connect over wifi, go to the Setup Instructions on the App Inventor Website to find out how to connect with a USB cable. AppyBuilder Beginner Tutorials - 10
- 12. Get the Connection Code from AppyBuilder and scan or type it into your Companion app On the Connect menu, choose "Live Testing". You can connect by: 1 - Scanning the QR code by clicking "Scan QR Code" (#1). or 2 - Typing the code into the text window and click "Connect with Code" (#2). AppyBuilder Beginner Tutorials - 11
- 13. See your app on the connected device You will know that your connection is successful when you see your app on the connected device. So far our app only has a button, so that is what you will see. As you add more to the project, you will see your app change on your phone. AppyBuilder Beginner Tutorials - 12
- 14. Change the Text on the Button On the properties pane, change the text for the Button. Select the text "Text for Button 1", delete it and type in "Talk To Me". Notice that the text on your app's button changes right away. AppyBuilder Beginner Tutorials - 13
- 15. Add a Text-to-Speech component to your app Go to the Media drawer and drag out a TextToSpeech component. Drag and Drop this component onto the Viewer. Notice that it drops down under "Non-visible components" because it is not something that will show up on the app's user interface. It's more like a tool that is available to the app. TIP: Non-visible components such as TextToSpeech, Sound, OrientationSensor are not seen and thus not a part of the User Interface screen, but they provide access to built-in functions of the Android device. AppyBuilder Beginner Tutorials - 14
- 16. Switch over to the Blocks Editor It's time to tell your app what to do! Click "Blocks" to move over to the Blocks Editor. Think of the Designer and Blocks buttons like tabs -- you use them to move back and forth between the two areas of AppyBuilder. AppyBuilder Beginner Tutorials - 15
- 17. The Blocks Editor The Blocks Editor is where you program the behavior or the logic of your app. There are Built-in blocks that handle things like math, logic, and text. Below that are the blocks that go with each of the components in your app. TIP: In order to get the blocks for a certain component to show up in the Blocks Editor, you first have to add that component to your app through the Designer. AppyBuilder Beginner Tutorials - 16
- 18. Make a button click event Click on the Button1 Drawer. Click and hold the when Button1.Click do block. Drag it over to the workspace and drop it there. This is the block that will handle what happens when the button on your app is clicked. It is called an "Event-Handler". TIP: Event-Handler describe how the phone should respond to certain events; e.g. a button has been pressed. TIP: Drawer is component specific and includes all event-handlers and blocks associated to the selected component. AppyBuilder Beginner Tutorials - 17
- 19. Program the TextToSpeech action Click on the TextToSpeech drawer. Click and hold the call TextToSpeech1.Speak block. Drag it over to the workspace and drop it there. This is the block that will make the phone speak. Snap this block right into Button1.Click event-handler. Because it is inside the Button.Click, it will run when the button on your app is clicked. AppyBuilder Beginner Tutorials - 18
- 20. Fill in the message socket on TextToSpeech.Speak Block Almost done! Now you just need to tell the TextToSpeech.Speak block what to say. To do that, click on the Text drawer, drag out a text block and plug it into the socket labeled "message". Specify what the app should say when the button is clicked Click on the text block and type in "Congratulations! You've made your first app." (Feel free to use any phrase you like, this is just a suggestion.) AppyBuilder Beginner Tutorials - 19
- 21. Now test it out! Go to your connected device and click the button. Make sure your volume is up! You should hear the phone speak the phrase out loud. Great job! Now move on to TalkToMe Part 2 to make the app respond to shaking and to let users put in whatever phrase they want. AppyBuilder Beginner Tutorials - 20
- 22. TalkToMe Part 2: Shaking and User Input This tutorial shows you how to extend the basic TalkToMe app so that it responds to shaking, and so that the user can make the phone say any phrase s/he types in. Go to AppyBuilder on the web and log in. Go to appybuilder.com and click "START BUILDING NOW!" or log in directly at http://gold.appybuilder.com. AppyBuilder Beginner Tutorials - 21
- 23. Open the "TalkToMe" project that you worked on in the last tutorial. AppyBuilder will always open the last project you worked on, so you may automatically be taken into your TalkToMe app. Go to the Designer Tab Your project may open in the Designer. If it does not, click "Designer" in the upper right. AppyBuilder Beginner Tutorials - 22
- 24. Add an Accelerometer Sensor In the Sensors drawer, drag out an AccelerometerSensor component and drop it onto the Viewer. (It's a non-visible component, so it drops to the bottom of the screen.) NOTE: emulator users should skip this part and proceed to the next section of this tutorial called "Say Anything". (The emulator can not respond to shaking!) AppyBuilder Beginner Tutorials - 23
- 25. Go to the Blocks Editor Click "Blocks" to program the new Accelerometer Sensor that you just added. Program the Accelerometer Shaking event Click the AccelerometerSensor1 drawer to see its blocks. Drag out the when AccelerometerSensor1.Shaking do block and drop it on the workspace. AppyBuilder Beginner Tutorials - 24
- 26. What do we want the app to do when the accelerometer detects shaking? Copy and paste the blocks that are currently inside the when Button1.Click event handler. You can select the purple block, then hit the key combination on your computer to copy and then to paste. You'll have a second set of blocks to put inside the when Accelerometer.Shaking block. (Alternatively, you can drag out a new call TextToSpeech1.Speak block from the TextToSpeech drawer, and a new pink text block from the Text drawer.) Change the phrase that is spoken when the phone is shaking. Type in something funny for when the phone responds to shaking. AppyBuilder Beginner Tutorials - 25
- 27. Test it out! You can now shake your phone and it should respond by saying "Stop shaking me!" (or whatever phrase you put in.) Say Anything Is your phone talking to you? Cool! Now let's program the button click so that it causes the phone to speak whatever phrase the user put into the text box. Go back to the Designer. AppyBuilder Beginner Tutorials - 26
- 28. Add a Text Box to your user interface. From the User Interface drawer, drag out a TextBox and put it above the Button that is already on the screen. Back to the Blocks Editor! AppyBuilder Beginner Tutorials - 27
- 29. Get the text that is typed into the TextBox. Get the text property of the TextBox1. The green blocks in the TextBox1 drawer are the "getters" and "setters" for the TextBox1 component. You want your app to speak out loud whatever is currently in the TextBox1 Text property (i.e. whatever is typed into the text box). Drag out the TextBox1.Text getter block. AppyBuilder Beginner Tutorials - 28
- 30. Set the Button Click event to speak the text that is in the Text Box. Pull out the "Congratulations..." text box and plug in the TextBox1.Text block. You can throw the pink text block away by dragging it to the trash in the lower right corner of the workspace. Test your app! Now your app has two behaviors: When the button is clicked, it will speak out loud whatever words are currently in the Text Box on the screen. (if nothing is there, it will say nothing.) The app will also say "Stop Shaking Me" when the phone is shaken. AppyBuilder Beginner Tutorials - 29
- 31. Congrats! You've built a real app! Give some thought to what else this app could do. Here are some ideas for extensions: ● Random phrase generator ● Mad Libs - player chooses noun, verb, adjective, adverb, person and it picks one from a list that you program. ● Magic 8 Ball App ● Name picker - useful for teachers to call on a student You could also play around with Speech-To-Text. Have fun! AppyBuilder Beginner Tutorials - 30
- 32. BallBounce: A simple game app In this tutorial, you will learn about animation in AppyBuilder by making a Ball (a sprite) bounce around on the screen (on a Canvas). Start a New Project If you have another project open, go to My Projects menu and choose New Project. AppyBuilder Beginner Tutorials - 31
- 33. Name the Project Call it something like "BallBounce". Remember, no spaces. But underscores are OK. Add a Canvas From the Drawing and Animation drawer, drag out a Canvas component and drop it onto the viewer. AppyBuilder Beginner Tutorials - 32
- 34. Set the Screen so that it does not scroll The default setting for AppyBuilder is that the screen of your app will be non scrollable, which means that the user interface can not go beyond the limit of the screen and the user can not scroll down by swiping their finger (like scrolling on a web page). When you are using a Canvas, you have to be sure to turn off the "Scrollable" setting (UNCHECK THE BOX) so that the screen does not scroll. This will allow you to make the Canvas to fill up the whole screen. AppyBuilder Beginner Tutorials - 33
- 35. Change the Height and Width of the Canvas to Fill Parent Make sure the Canvas component is selected (#1) so that its properties show up in the Properties Pane (#2). Down at the bottom, set the Height property to "Fill Parent". Do the same with the Width property. AppyBuilder Beginner Tutorials - 34
- 36. Add a Ball Now that we have a Canvas in place, we can add a Ball Sprite. This can also be found in the Drawing and Animation drawer. Drag out a Ball component and drop it onto the Canvas (#1). If you'd like the ball to show up better, you can change its Radius property in the Properties pane (#2). Open the Blocks Editor. AppyBuilder Beginner Tutorials - 35
- 37. Open the Ball1 Drawer to view the Ball's blocks. Drag out the Flung Event Handler Choose the block when Ball1.Flung and drag-and-drop it onto the workspace. Flung refers to the user making a "Fling gesture" with his/her finger to "fling" the ball. Fling is a gesture like what a golf club does, not like how you launch Angry Birds! In App Inventor, the event handler for that type of gesture is called when Flung. AppyBuilder Beginner Tutorials - 36
- 38. Set the Ball's Heading and Speed. First get the setter blocks. Open the Ball drawer and scroll down in the list of blocks to get the set Ball1.Heading and set Ball1.Speed blocks AppyBuilder Beginner Tutorials - 37
- 39. Plug the set Ball1.Speed and set Ball1.Heading into the Fling event handler Set the Ball's speed to be the same as the Fling gesture's speed Mouse over the "speed" parameter of the when Ball1.Flung event handler. The get and set blocks for the speed of the fling will pop up. Grab the get speed block and plug that into the set Ball1.Speed block. AppyBuilder Beginner Tutorials - 38
- 40. Set the Ball's heading to be the same as the Fling gesture's heading Do the same for the Ball's heading. Mouse over the heading parameter and you'll see the get heading block appear. Grab that block, and click it into the set Ball1.Heading block. AppyBuilder Beginner Tutorials - 39
- 41. Test it out A good habit while building apps is to test while you build. AppyBuilder lets you do this easily because you can have a live connection between your phone (or emulator) and the AppyBuilder development environment. If you don't have a phone (or emulator) connected, go to the connection instructions and then come back to this tutorial. (Connection instructions are in Tutorial #1 or on the website under "Getting Started".) Why does the Ball get stuck on the side of the screen?! After flinging your ball across the screen, you probably noticed that it got stuck on the side. This is because the ball's heading has not changed even though it hit the side of the canvas. To make the ball "bounce" of the edge of the screen, we can program in a new event handler called "When Edge Reached". AppyBuilder Beginner Tutorials - 40
- 42. Add an Edge Reached Event Go into the Ball1 drawer and pull out a when Ball1.EdgeReached do event. AppyBuilder Beginner Tutorials - 41
- 43. Go back into the Ball1 drawer and pull out a Ball.Bounce block. Add the edge value for the Ball.Bounce block The Ball.Bounce method needs an edge argument. Notice that the Ball1.EdgeReached event has an "edge" as a parameter. We can take the get edge block from that argument and plug it into the call Ball1.Bounce method. Grab the get edge block by mousing over (hover your mouse pointer over) the "edge" parameter on the when Ball1.EdgeReached block. AppyBuilder Beginner Tutorials - 42
- 44. Your final blocks should look like this. Now test it out! AppyBuilder Beginner Tutorials - 43
- 45. Test it out! Now, when you fling the ball, it should bounce off the edges of the canvas. Great job! There are many ways to extend this app. Here are some ideas... but the possibilities are endless! ● Change the color of the ball based on how fast it is moving or which edge it reaches. ● Scale the speed of the ball so that it slows down and stops after it gets flung. ● Give the ball obstacles or targets to hit ● Introduce a paddle for intercepting the ball, like a Pong game Visit the AppyBuilder website to find tutorials that help you extend this app, particularly the Mini Golf tutorial. Have fun with these extensions, or others that you think up! AppyBuilder Beginner Tutorials - 44
- 46. DigitalDoodle: Drawing App This tutorial will show you how to draw a line on the screen as the user drags a finger around. Start a New Project From the My Projects page, click New Project. If you have another project open, go to My Projects menu and choose New Project. Name the Project Call this project DigitalDoodle, or create your own name for this drawing app. AppyBuilder Beginner Tutorials - 45
- 47. Set the Screen so that it does not scroll The default setting for AppyBuilder is that the screen of your app will be non scrollable, which means that the user interface can not go beyond the limit of the screen and the user can not scroll down by swiping their finger (like scrolling on a web page). When you are using a Canvas, you have to be sure to turn off the "Scrollable" setting (UNCHECK THE BOX) so that the screen does not scroll. This will allow you to make the Canvas to fill up the whole screen. AppyBuilder Beginner Tutorials - 46
- 48. Add a Canvas From the Drawing and Animation drawer, drag out a Canvas component. AppyBuilder Beginner Tutorials - 47
- 49. Change the Height and Width of the Canvas to Fill Parent Make sure the Canvas component is selected (#1) so that its properties show up in the Properties Pane (#2). Down at the bottom, set the Height property to "Fill Parent". Do the same with the Width property. That's all for the Designer! Go over to the Blocks. Believe it or not, for now this app only needs a Canvas. Go into the Blocks Editor to program the app. AppyBuilder Beginner Tutorials - 48
- 50. Get a Canvas.Dragged event block In the Canvas1 drawer, pull out the when Canvas1.Dragged event. AppyBuilder Beginner Tutorials - 49
- 51. Get a Canvas.DrawLine call block In the Canvas1 drawer, pull out the when Canvas1.DrawLine method block. AppyBuilder Beginner Tutorials - 50
- 52. Use the get and set blocks from the Dragged block to fill in the values for the Draw Line block. The Canvas Dragged event will happen over and over again very rapidly while the user drags a finger on the screen. Each time that Dragged event block is called, it will draw a small line between the previous location (prevX, prevY) of the finger to the new location (currentX, currentY). Mouse over the parameters of the Canvas1.Dragged block to pull out the get blocks that you need. (Mouse over them, don't click on them.) AppyBuilder Beginner Tutorials - 51
- 53. Test it out! Go to your connected device and drag your finger around the screen. Can you make a happy face? AppyBuilder Beginner Tutorials - 52
- 54. Great work! Now extend this app Here are some ideas for extending this app. You can probably think of many more! ● Change the color of the ink (and let the user pick from a selection of colors). See Paint Pot tutorial. ● Change the background to a photograph or picture. ● Let the user draw dots as well as lines (hint: Use DrawCircle block). ● Add a button that turns on the camera and lets the user take a picture and then doodle on it. AppyBuilder Beginner Tutorials - 53