dialer-app

Merge lp:~renatofilho/dialer-app/swipe-item-demo into lp:dialer-app

swipe-item-demo
Merge into trunk

Proposed by Renato Araujo Oliveira Filho on 2015-02-26

Status:

Merged

Approved by:

Gustavo Pichorim Boiko on 2015-05-07

Approved revision:

385

Merged at revision:

402

Proposed branch:

lp:~renatofilho/dialer-app/swipe-item-demo

Merge into:

lp:dialer-app

Diff against target:

552 lines (+485/-1)

5 files modified

src/qml/HistoryPage/HistoryPage.qml (+16/-0)
src/qml/HistoryPage/SwipeItemDemo.qml (+397/-0)
src/qml/assets/swipe_arrow.svg (+17/-0)
tests/autopilot/dialer_app/tests/__init__.py (+23/-1)
tests/autopilot/dialer_app/tests/test_logs.py (+32/-0)

To merge this branch:

bzr merge lp:~renatofilho/dialer-app/swipe-item-demo

High

Fix Released

Link a bug report

Reviewer	Review Type	Date Requested	Status
Gustavo Pichorim Boiko (community)		2015-02-26	Approve on 2015-05-07
PS Jenkins bot	continuous-integration		Needs Fixing on 2015-05-07
Review via email: mp+251085@code.launchpad.net

Commit Message

Create a swipe item demo. To demonstrate how to swipe items to revel actions.

Description of the Change

You will need this to get this working: https://code.launchpad.net/~renatofilho/address-book-app/list-with-actions-animated/+merge/251086

PS Jenkins bot (ps-jenkins) wrote on 2015-02-26:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/517/rebuild

review: Needs Fixing (continuous-integration)

lp:~renatofilho/dialer-app/swipe-item-demo updated on 2015-02-26

374. By Renato Araujo Oliveira Filho on 2015-02-26: Show a fake missed call on Swipe demo.
Only shows the demo if the list is populated.

PS Jenkins bot (ps-jenkins) wrote on 2015-02-26:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/518/rebuild

review: Needs Fixing (continuous-integration)

lp:~renatofilho/dialer-app/swipe-item-demo updated on 2015-04-27

375. By Renato Araujo Oliveira Filho on 2015-04-27: Trunk merged.

PS Jenkins bot (ps-jenkins) wrote on 2015-04-27:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/539/rebuild

review: Needs Fixing (continuous-integration)

PS Jenkins bot (ps-jenkins) wrote on 2015-04-28:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/542/rebuild

review: Needs Fixing (continuous-integration)

lp:~renatofilho/dialer-app/swipe-item-demo updated on 2015-04-28

376. By Renato Araujo Oliveira Filho on 2015-04-28: Updated visuals.
377. By Renato Araujo Oliveira Filho on 2015-04-28: Update visuals.

PS Jenkins bot (ps-jenkins) wrote on 2015-04-29:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/543/rebuild

review: Needs Fixing (continuous-integration)

lp:~renatofilho/dialer-app/swipe-item-demo updated on 2015-04-29

378. By Renato Araujo Oliveira Filho on 2015-04-29: Disable click outside the ok button while the swipe item demo is running.

PS Jenkins bot (ps-jenkins) wrote on 2015-04-29:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/545/rebuild

review: Needs Fixing (continuous-integration)

lp:~renatofilho/dialer-app/swipe-item-demo updated on 2015-04-29

379. By Renato Araujo Oliveira Filho on 2015-04-29: Added missing svg file.
380. By Renato Araujo Oliveira Filho on 2015-04-29: Created auto pilot tests.

PS Jenkins bot (ps-jenkins) wrote on 2015-04-30:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/546/rebuild

review: Needs Fixing (continuous-integration)

Gustavo Pichorim Boiko (boiko) wrote on 2015-05-01:

I think it would be a good idea to have the view fading in when appearing and fading out when dismissing.

review: Needs Fixing

lp:~renatofilho/dialer-app/swipe-item-demo updated on 2015-05-01

381. By Renato Araujo Oliveira Filho on 2015-05-01: Created animations for the tutorial appear and desapear

PS Jenkins bot (ps-jenkins) wrote on 2015-05-01:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/549/rebuild

review: Needs Fixing (continuous-integration)

lp:~renatofilho/dialer-app/swipe-item-demo updated on 2015-05-01

382. By Renato Araujo Oliveira Filho on 2015-05-01: Added a fade out in the texts.

PS Jenkins bot (ps-jenkins) wrote on 2015-05-02:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/550/rebuild

review: Needs Fixing (continuous-integration)

Renato Araujo Oliveira Filho (renatofilho) wrote on 2015-05-06:

Are there any related MPs required for this MP to build/function as expected?
- lp:~renatofilho/address-book-app/list-with-actions-animated

Is your branch in sync with latest trunk?
YES

Did you perform an exploratory manual test run of your code change and any related functionality on device or emulator?
YES

Did you successfully run all tests found in your component's Test Plan on device or emulator?
YES

If you changed the UI, was the change specified/approved by design?
YES

If you changed UI labels, did you update the pot file?
NO, Will be updated in a diff MR

If you changed the packaging (debian), did you add a core-dev as a reviewer to this MP?
NO PACKAGE CHANGED

Gustavo Pichorim Boiko (boiko) wrote on 2015-05-06:

If I open the recents view without having any item on it, and then I receive a call (no need to answer the call, just let it show as missed), the demo is not displayed.

Can you fix that?

review: Needs Fixing

lp:~renatofilho/dialer-app/swipe-item-demo updated on 2015-05-07

383. By Renato Araujo Oliveira Filho on 2015-05-06: Show swipe demo if receive a call while the recents is open.
384. By Renato Araujo Oliveira Filho on 2015-05-07: Fix autopilot.

PS Jenkins bot (ps-jenkins) wrote on 2015-05-07:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/552/rebuild

review: Needs Fixing (continuous-integration)

PS Jenkins bot (ps-jenkins) wrote on 2015-05-07:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/553/rebuild

review: Needs Fixing (continuous-integration)

lp:~renatofilho/dialer-app/swipe-item-demo updated on 2015-05-07

385. By Renato Araujo Oliveira Filho on 2015-05-07: Trunk merged.

PS Jenkins bot (ps-jenkins) wrote on 2015-05-07:

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/dialer-app-ci/555/rebuild

review: Needs Fixing (continuous-integration)

Gustavo Pichorim Boiko (boiko) wrote on 2015-05-07:

Did you perform an exploratory manual test run of the code change and any related functionality on device or emulator?
Yes

Did CI run pass? If not, please explain why.
No, but not related to the changes.

Have you checked that submitter has accurately filled out the submitter checklist and has taken no shortcut?
Yes

review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk

Subscribers

People subscribed via source and target branches

to all changes:

Ishan Joshi

Renato Araujo Oliveira Filho

Ubuntu Phablet Team

 === modified file 'src/qml/HistoryPage/HistoryPage.qml'
 --- src/qml/HistoryPage/HistoryPage.qml	2015-04-09 19:55:20 +0000
 +++ src/qml/HistoryPage/HistoryPage.qml	2015-05-07 13:03:26 +0000
@@ -94,6 +94,8 @@
+             }
              historyList.resetSwipe()
              historyList.positionViewAtBeginning()
++        } else if (historyList.count > 0){
++            swipeItemDemo.enable()
+         }
+     }
@@ -354,10 +356,24 @@
+                 ]
+             }
+         }
++
++        onCountChanged: {
++            if (historyPage.active && (historyList.count > 0)) {
++                swipeItemDemo.enable()
++            }
++        }
+     }
      Scrollbar {
          flickableItem: historyList
          align: Qt.AlignTrailing
+     }
++
++    SwipeItemDemo {
++        id: swipeItemDemo
++        objectName: "swipeItemDemo"
++
++        parent: QuickUtils.rootItem(this)
++        anchors.fill: parent
++    }
+ }
 === added file 'src/qml/HistoryPage/SwipeItemDemo.qml'
 --- src/qml/HistoryPage/SwipeItemDemo.qml	1970-01-01 00:00:00 +0000
 +++ src/qml/HistoryPage/SwipeItemDemo.qml	2015-05-07 13:03:26 +0000
@@ -0,0 +1,397 @@
++/*
++ * Copyright 2012-2015 Canonical Ltd.
++ *
++ * This file is part of dialer-app.
++ *
++ * dialer-app is free software; you can redistribute it and/or modify
++ * it under the terms of the GNU General Public License as published by
++ * the Free Software Foundation; version 3.
++ *
++ * dialer-app is distributed in the hope that it will be useful,
++ * but WITHOUT ANY WARRANTY; without even the implied warranty of
++ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
++ * GNU General Public License for more details.
++ *
++ * You should have received a copy of the GNU General Public License
++ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
++ */
++
++import QtQuick 2.0
++import QtQuick.Layouts 1.1
++import Qt.labs.settings 1.0
++
++import Ubuntu.Components 1.1
++import Ubuntu.Contacts 0.1
++
++Loader {
++    id: root
++
++    property bool necessary: true
++    property bool enabled: false
++
++
++    function enable() {
++        root.enabled = true;
++    }
++
++    function disable() {
++        if (root.enabled) {
++            root.necessary = false;
++            root.enabled = false;
++        }
++    }
++
++    sourceComponent: necessary && enabled ? listItemDemoComponent : null
++
++    Settings {
++        property alias hintNecessary: root.necessary
++    }
++
++    Component {
++        id: listItemDemoComponent
++
++        Rectangle {
++            id: rectangleContents
++
++            color: "black"
++            opacity: 0
++            anchors.fill: parent
++
++            Behavior on opacity {
++                UbuntuNumberAnimation {
++                    duration:  UbuntuAnimation.SlowDuration
++                }
++            }
++
++            ListItemWithActions {
++                id: listItem
++
++                property int xPos: 0
++
++                animated: false
++                onXPosChanged: listItem.updatePosition(xPos)
++
++                anchors {
++                    top: parent.top
++                    topMargin: units.gu(14)
++                    left: parent.left
++                    right: parent.right
++                }
++                height: units.gu(8)
++
++                color: Theme.palette.normal.background
++                leftSideAction: Action {
++                    iconName: "delete"
++                }
++                rightSideActions: [
++                    Action {
++                        iconName: "info"
++                    },
++                    Action {
++                        iconName: "message"
++                    },
++                    Action {
++                        iconName: "stock_contact"
++                    }
++                ]
++
++                ContactAvatar {
++                    id: avatar
++                    anchors {
++                        left: parent.left
++                        top: parent.top
++                        bottom: parent.bottom
++                    }
++                    width: height
++                    fallbackAvatarUrl: "image://theme/stock_contact"
++                    fallbackDisplayName: "Ubuntu phone"
++                    showAvatarPicture: true
++                }
++
++                Label {
++                    id: titleLabel
++                    anchors {
++                        top: parent.top
++                        topMargin: units.gu(0.5)
++                        left: avatar.right
++                        leftMargin: units.gu(2)
++                        right: time.left
++                        rightMargin: units.gu(1) + (countLabel.visible ? countLabel.width : 0)
++                    }
++                    height: units.gu(2)
++                    verticalAlignment: Text.AlignTop
++                    fontSize: "medium"
++                    text: "(541) 754-3010"
++                    elide: Text.ElideRight
++                    color: UbuntuColors.lightAubergine
++                }
++
++                // this item has the width of the text above. It is used to be able to align
++                Item {
++                    id: titleLabelArea
++                    anchors {
++                        top: titleLabel.top
++                        left: titleLabel.left
++                        bottom: titleLabel.bottom
++                    }
++                    width: titleLabel.paintedWidth
++                }
++
++                Label {
++                    id: countLabel
++                    anchors {
++                        left: titleLabelArea.right
++                        leftMargin: units.gu(0.5)
++                        top: titleLabel.top
++                    }
++                    height: units.gu(2)
++                    fontSize: "medium"
++                    // TRANSLATORS: this is the count of events grouped into this single item
++                    text: i18n.tr("(%1)").arg(2)
++                }
++
++                Label {
++                    id: phoneLabel
++                    anchors {
++                        top: titleLabel.bottom
++                        topMargin: units.gu(1)
++                        left: avatar.right
++                        leftMargin: units.gu(2)
++                    }
++                    height: units.gu(2)
++                    verticalAlignment: Text.AlignTop
++                    fontSize: "small"
++                    text: i18n.tr("Mobile")
++                }
++
++                // time and duration on the right side of the delegate
++                Label {
++                    id: time
++                    anchors {
++                        right: parent.right
++                        bottom: titleLabel.bottom
++                    }
++                    height: units.gu(2)
++                    verticalAlignment: Text.AlignBottom
++                    fontSize: "small"
++                    text: Qt.formatTime( new Date(), Qt.DefaultLocaleShortDate)
++                }
++
++                Label {
++                    id: callType
++                    anchors {
++                        right: parent.right
++                        bottom: phoneLabel.bottom
++                    }
++                    height: units.gu(2)
++                    verticalAlignment: Text.AlignBottom
++                    fontSize: "small"
++                    text: i18n.tr("Incoming")
++                }
++            }
++
++            RowLayout {
++                id: dragTitle
++
++                anchors {
++                    left: parent.left
++                    right: parent.right
++                    top: listItem.bottom
++                    margins: units.gu(1)
++                    //topMargin: units.gu(1)
++                }
++                height: units.gu(3)
++                spacing: units.gu(2)
++
++                Image {
++                    visible: listItem.swipeState === "RightToLeft"
++                    source: Qt.resolvedUrl("../assets/swipe_arrow.svg")
++                    rotation: 180
++                    Layout.preferredWidth: sourceSize.width
++                    height: parent.height
++                    verticalAlignment: Image.AlignVCenter
++                    fillMode: Image.Pad
++                    sourceSize {
++                        width: units.gu(7)
++                        height: units.gu(2)
++                    }
++                }
++
++                Label {
++                    id: dragMessage
++
++                    Layout.fillWidth: true
++                    height: parent.height
++                    verticalAlignment: Image.AlignVCenter
++                    wrapMode: Text.Wrap
++                    fontSize: "large"
++                    color: "#ffffff"
++                }
++
++                Image {
++                    visible: listItem.swipeState === "LeftToRight"
++                    source: Qt.resolvedUrl("../assets/swipe_arrow.svg")
++                    Layout.preferredWidth: sourceSize.width
++                    height: parent.height
++                    verticalAlignment: Image.AlignVCenter
++                    fillMode: Image.Pad
++                    sourceSize {
++                        width: units.gu(7)
++                        height: units.gu(2)
++                    }
++                }
++            }
++
++            Button {
++                objectName: "gotItButton"
++
++                anchors {
++                    bottom: parent.bottom
++                    horizontalCenter: parent.horizontalCenter
++                    bottomMargin: units.gu(9)
++                }
++                width: units.gu(17)
++                strokeColor: UbuntuColors.green
++                text: i18n.tr("Got it")
++                enabled: !dismissAnimation.running
++                onClicked: dismissAnimation.start()
++                InverseMouseArea {
++                    anchors.fill: parent
++                    topmostItem: true
++                }
++            }
++
++            SequentialAnimation {
++                id: slideAnimation
++
++                readonly property real leftToRightXpos: (-3 * (listItem.actionWidth + units.gu(2)))
++                readonly property real rightToLeftXpos: listItem.leftActionWidth
++
++                loops: Animation.Infinite
++                running: root.enabled
++
++                PropertyAction {
++                    target: dragMessage
++                    property: "text"
++                    value: i18n.tr("Swipe to reveal actions")
++                }
++
++                PropertyAction {
++                    target: dragMessage
++                    property: "horizontalAlignment"
++                    value: Text.AlignLeft
++                }
++
++                ParallelAnimation {
++                    PropertyAnimation {
++                        target:  listItem
++                        property: "xPos"
++                        from: 0
++                        to: slideAnimation.leftToRightXpos
++                        duration: 2000
++                    }
++                    PropertyAnimation {
++                        target: dragTitle
++                        property: "opacity"
++                        from: 0
++                        to: 1
++                        duration: UbuntuAnimation.SleepyDuration
++                    }
++                }
++
++                PauseAnimation {
++                    duration: UbuntuAnimation.SleepyDuration
++                }
++
++                ParallelAnimation {
++                    PropertyAnimation {
++                        target: dragTitle
++                        property: "opacity"
++                        to: 0
++                        duration: UbuntuAnimation.SlowDuration
++                    }
++
++                    PropertyAnimation {
++                        target: listItem
++                        property: "xPos"
++                        from: slideAnimation.leftToRightXpos
++                        to: 0
++                        duration: UbuntuAnimation.SleepyDuration
++                    }
++                }
++
++                PropertyAction {
++                    target: dragMessage
++                    property: "text"
++                    value: i18n.tr("Swipe to delete")
++                }
++
++                PropertyAction {
++                    target: dragMessage
++                    property: "horizontalAlignment"
++                    value: Text.AlignRight
++                }
++
++                ParallelAnimation {
++                    PropertyAnimation {
++                        target: listItem
++                        property: "xPos"
++                        from: 0
++                        to: slideAnimation.rightToLeftXpos
++                        duration: UbuntuAnimation.SleepyDuration
++                    }
++                    PropertyAnimation {
++                        target: dragTitle
++                        property: "opacity"
++                        from: 0
++                        to: 1
++                        duration: UbuntuAnimation.SlowDuration
++                    }
++                }
++
++                PauseAnimation {
++                    duration: UbuntuAnimation.SleepyDuration
++                }
++
++                ParallelAnimation {
++                    PropertyAnimation {
++                        target: dragTitle
++                        property: "opacity"
++                        to: 0
++                        duration: UbuntuAnimation.SlowDuration
++                    }
++
++                    PropertyAnimation {
++                        target: listItem
++                        property: "xPos"
++                        from: slideAnimation.rightToLeftXpos
++                        to: 0
++                        duration: UbuntuAnimation.SleepyDuration
++                    }
++                }
++            }
++
++            SequentialAnimation {
++                id: dismissAnimation
++
++                alwaysRunToEnd: true
++                running: false
++
++                UbuntuNumberAnimation {
++                    target: rectangleContents
++                    property: "opacity"
++                    to: 0.0
++                    duration:  UbuntuAnimation.SlowDuration
++                }
++
++                ScriptAction {
++                    script: root.disable()
++                }
++            }
++
++            Component.onCompleted: {
++                opacity = 0.85
++            }
++        }
++    }
++}
 === added file 'src/qml/assets/swipe_arrow.svg'
 --- src/qml/assets/swipe_arrow.svg	1970-01-01 00:00:00 +0000
 +++ src/qml/assets/swipe_arrow.svg	2015-05-07 13:03:26 +0000
@@ -0,0 +1,17 @@
++<?xml version="1.0" encoding="utf-8"?>
++<!-- Generator: Adobe Illustrator 18.1.1, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
++<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
++	 viewBox="0 0 96.6 36.7" enable-background="new 0 0 96.6 36.7" xml:space="preserve">
++<g>
++
++		<path id="path2194-5_2_" inkscape:connector-curvature="0" sodipodi:nodetypes="ccsssccc" inkscape:transform-center-x="-0.02188882" inkscape:transform-center-y="-31.980969" fill="#DC4B26" d="
++		M96,18.7c-10.5-7.3-21.3-12-21.3-12l0,24"/>
++	<circle id="circle4146" fill="#DC4B26" cx="69.2" cy="18.3" r="2.4"/>
++	<circle id="circle4148" fill="#DC4B26" cx="58.5" cy="18.3" r="2.4"/>
++	<circle id="circle4150" fill="#DC4B26" cx="47.8" cy="18.3" r="2.4"/>
++	<circle id="circle4152" fill="#DC4B26" cx="37.1" cy="18.3" r="2.4"/>
++	<circle id="circle4154" fill="#DC4B26" cx="26.4" cy="18.3" r="2.4"/>
++	<circle id="circle4156" fill="#DC4B26" cx="15.7" cy="18.3" r="2.4"/>
++</g>
++<circle id="circle4156_1_" fill="#DC4B26" cx="4.9" cy="18.3" r="2.4"/>
++</svg>
 === modified file 'tests/autopilot/dialer_app/tests/__init__.py'
 --- tests/autopilot/dialer_app/tests/__init__.py	2014-08-13 18:08:11 +0000
 +++ tests/autopilot/dialer_app/tests/__init__.py	2015-05-07 13:03:26 +0000
@@ -11,6 +11,7 @@
  import logging
  import os
++import tempfile
  import fixtures
  import ubuntuuitoolkit
@@ -40,9 +41,10 @@
      LOCAL_BINARY_PATH = 'src/dialer-app'
      # The path to the locally built binary, relative to the build directory.
--    def setUp(self):
++    def setUp(self, firstLaunch=False):
          super().setUp()
          self.set_up_locale()
++        self.create_config_file(firstLaunch)
          self.launch_application()
          self.assertThat(self.main_view.visible, Eventually(Equals(True)))
@@ -78,6 +80,26 @@
              emulator_base=ubuntuuitoolkit.UbuntuUIToolkitCustomProxyObjectBase
+         )
++    def create_config_file(self, firstLaunch=False):
++        self.user_config_dir = tempfile.mkdtemp(suffix='', prefix='dialer-app')
++        self.app_config_dir = (self.user_config_dir + '/com.ubuntu.dialer-app/')
++        os.makedirs(self.app_config_dir)
++        config_file_path = (self.app_config_dir + '/DialerApp.conf')
++
++        if firstLaunch:
++            first_launch_flag = 'true'
++        else:
++            first_launch_flag = 'false'
++        with open(config_file_path, 'w') as config_file:
++            config_file.write('[General]\nhintNecessary=%s\n' % (first_launch_flag))
++
++        self.useFixture(
++            fixtures.EnvironmentVariable('XDG_CONFIG_HOME', newvalue=self.user_config_dir)
++        )
++        self.useFixture(
++            fixture_setup.InitctlEnvironmentVariable(XDG_CONFIG_HOME=self.user_config_dir)
++        )
++
      @property
      def main_view(self):
          return self.app.wait_select_single(dialer_app.MainView)
 === modified file 'tests/autopilot/dialer_app/tests/test_logs.py'
 --- tests/autopilot/dialer_app/tests/test_logs.py	2015-04-15 17:31:01 +0000
 +++ tests/autopilot/dialer_app/tests/test_logs.py	2015-05-07 13:03:26 +0000
@@ -79,3 +79,35 @@
              Eventually(Equals(
                  'addressbook:///addnewphone?callback=dialer-app.desktop&'
                  'phone=800')))
++
++
++class TestSwipeItemTutorial(DialerAppTestCase):
++    """Tests for swipe item tutorial."""
++
++    def setUp(self):
++        # set the fixtures before launching the app
++        testability_environment = fixture_setup.TestabilityEnvironment()
++        self.useFixture(testability_environment)
++        fill_history = fixture_setup.FillCustomHistory()
++        self.useFixture(fill_history)
++
++        # now launch the app
++        super().setUp(firstLaunch=True)
++        self.main_view.dialer_page.reveal_bottom_edge_page()
++
++    def _get_main_view(self, proxy_object):
++        return proxy_object.wait_select_single('QQuickView')
++
++    def test_swipe_item_tutorial_appears(self):
++        """Ensure that the swipe item tutorial appears on first launch"""
++        swipe_item_demo = self.main_view.wait_select_single(
++            'SwipeItemDemo', objectName='swipeItemDemo')
++
++        self.assertThat(swipe_item_demo.enabled, Eventually(Equals(True)))
++        self.assertThat(swipe_item_demo.necessary, Eventually(Equals(True)))
++        got_it_button = swipe_item_demo.select_single(
++            'Button',
++            objectName='gotItButton')
++        self.main_view._click_button(got_it_button)
++        self.assertThat(swipe_item_demo.enabled, Eventually(Equals(False)))
++        self.assertThat(swipe_item_demo.necessary, Eventually(Equals(False)))