Jan Piotrowski (Sujan) created CB-13442:
-------------------------------------------

             Summary: Why different "handling" for platform specific options / 
build params / flags in iOS and Android?
                 Key: CB-13442
                 URL: https://issues.apache.org/jira/browse/CB-13442
             Project: Apache Cordova
          Issue Type: Improvement
          Components: cordova-android, cordova-docs, cordova-ios
            Reporter: Jan Piotrowski (Sujan)
            Assignee: Joe Bowser
            Priority: Trivial


For Android signing flags, at other places (CLI docs) referred to as "platform 
options", we have examples like this:

{code}
cordova run android --release -- --keystore=../my-release-key.keystore 
--storePassword=password --alias=alias_name --password=password
{code}
Source: 
https://cordova.apache.org/docs/en/latest/guide/platforms/android/#using-flags

Note the additional `--` that seperates 
`--keystore` etc from the rest.


But for iOS we have this example:

{code}
cordova build --device --buildFlag="MYSETTING=myvalue" 
--buildFlag="MY_OTHER_SETTING=othervalue"
{code}
Source: 
https://cordova.apache.org/docs/en/latest/guide/platforms/ios/index.html#xcode-build-flags

`--buildFlag`is clearly a platform specific option as it is not listed on 
https://cordova.apache.org/docs/en/latest/reference/cordova-cli/index.html#cordova-build-command

Why does this not need an additional `--`?

Also, there are no examples (that I could find) for the iOS platform specific 
params in the CLI docs and general docs, they are only listed here: 
https://cordova.apache.org/docs/en/latest/guide/platforms/ios/index.html#using-flags
How would these have to be separated from the actual command?


----


No matter what the result, I think 2 things should happen in the docs:

1. Naming of these params should be unified and crosslinked so it is clear that 
this is the same thing. I wasn't really clear about this until now. Are there 
more?
2. There should also be examples for the iOS platform specific params / flags



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org
For additional commands, e-mail: issues-h...@cordova.apache.org

Reply via email to