quasarframework / quasar-framework.org

[DEPRECATED, v0.17] Quasar Framework - The Official Website
https://quasar-framework.org
MIT License
110 stars 314 forks source link

todo: update cordova iOS docs #653

Open mesqueeb opened 5 years ago

mesqueeb commented 5 years ago

Chapters like iOS publishing > Signing seem a bit outdated.

Now that you linked Xcode with your developer account, go to Preferences > Accounts, select your Apple Id on the left-hand side and then click the View Details button shown on the previous image. Click the Create button next to the iOS Distribution option.

I cannot find "View Details" or "create".

2019-01-07 00 54 04

Once I'm able to get my first app up and running I'll make some PR's on the docs.

mesqueeb commented 5 years ago

Todo:

Creating the app listing

Apple uses iTunes Connect to manage app submissions. After your login, you should select the My Apps button, and on the next screen select the + button, just below the iTunes Connect My Apps header.

This is called "App Store Connect" now I think. Just adding the note so I don't forget to PR.

mesqueeb commented 5 years ago

Creating an archive of the application

Next, select Product > Archive, and the Archive organizer appears and displays the new archive. At this point you can click the Upload to App Store... button, and if everything goes fine you’ll have an uploaded app, and the only thing that’s left to do is to complete the iTunes Connect listing and submit it for review!

Add in between the above two lines:

Click on "distribute app" > "iOS app store" > "upload" then go through the next options with the default choices.

image
mesqueeb commented 5 years ago

add info on:

choosing a simulator

quasar dev -m cordova -T ios -e iPad-Air

This will open a simulator in the device you specify. Quasar will make sure that hot reload stays active, so you can continue coding and the simulator will stay in sync with your src code.

For a list of possible devices to choose from cordova emulate ios --list

developing directly on phone

If you connect an iOS device via USB you can develop with hot reload and all changes are instantly updated on your phone! This is the best mode to develop to assure everything works correctly on the actual device. This is also important for some features that will not work on the simulator, like:

It's sometimes a challenge to get this to work the first time.

  1. you must update your dev command and delete the line -e iPad-Air or any device you've added like this (as described in the previous chapter)!
  2. the very first time you might need to open Xcode and choose your actual device in the top left corner and you will need to manually press build ( ▶ ) once to make sure the app is correctly installable on your phone
  3. then you can try quasar dev -m cordova -T ios again
    • If nothing happens but you also get no specific error, try building first with quasar build -m cordova -T ios and see if you get an error then.
    • If you are getting a white screen, try choosing another IP address when Quasar asks you
    • If you get specific build errors, it's better to google these as they are always a problem with your cordova setup and not with the Quasar framework.

One build problem you'll probably encounter is:

/Info.plist file not found.

This is because the latest Cordova version is not yet compatible with the latest build method in Xcode 10. To be able to have your build work with Xcode 10 you need to add a build.json file to your src-cordova folder and add this:

{
  "ios": {
    "debug": {
      "buildFlag": [
        "-UseModernBuildSystem=0"
      ]
    },
    "release": {
      "buildFlag": [
        "-UseModernBuildSystem=0"
      ]
    }
  }
}

Then you need to select the "Legacy Build System" in Xcode before you archive your app, because Cordova is not yet compatible with the new build system. Go to "file" > "project settings" (or workspace settings) and then select "Legacy Build System".