通过 Cordova config.xml 向 iOS. plist 文件添加条目

我是科尔多瓦 CLI 的新成员。

我需要通过 Cordova 程序化地执行以下步骤。

  1. 在 project. plist 中添加一个新行
  2. 在新行中输入以下值:
  3. : GDLibraryMode 类型: String (默认) 价值: GDEnterpriseSimulation

我认为我需要在项目根目录下的 config.xml 文件中(或者在“ Platform”文件夹中)执行此操作。

有人能向我解释一下如何通过 config.xml 添加条目,以便在编译时添加上述条目吗?

我正在使用 Cordova 3.3.1-0.42(我知道它不是最新的)。我已经完成了我的项目,一切都很好,我只需要将这个条目添加到 pList 中。


编辑: 2/8/21 根据对这个问题的评论:

对于任何迟到的人来说,科尔多瓦 CLI 7及以上现在支持在项目列表中设置值

77082 次浏览

you just need following steps 1.

Go to Project navigator Select the target Click on info from tab option other option are build setting build phase you will see key type value When you point on any key name you will find + and - sign click on the + sign write Key: GDLibraryMode in key section Type:Stringin tyoe section Value:GDEnterpriseSimulation in value section

I don't think you can do this via straight config.xml modification. At least, I didn't see any mention of this in the docs: http://cordova.apache.org/docs/en/3.3.0/config_ref_index.md.html

I think you have to create a plugin, because they can insert plist entries: http://docs.phonegap.com/en/3.3.0/plugin_ref_spec.md.html#Plugin%20Specification

See the 'config-file element' section. Here's a guess as to what the relevant section of the plugin.xml will look like:

<platform name="ios">
<config-file target="*-Info.plist" parent="CFBundleURLTypes">
<array>
<dict>
<key>GDLibraryMode</key>
<string>GDEnterpriseSimulation</string>
</dict>
</array>
</config-file>
</platform>

Then you can install the plugin: cordova plugin add <your plugin name or file location>

You can set the display name in app's plist by directly editing the ios.json in the plugins directory.

Adding the following to the config_munge.files section of the ios.json file will do the trick and it will be maintained even when using the CLI.

"*-Info.plist": {


"parents": {
"CFBundleDisplayName": [
{
"xml": "<string>RevMob Ads Cordova Plugin Demo</string>",
"count": 1
}
]
}
}

Here's a complete example

You can use the PlistBuddy utility inside a Cordova hook script to modify the *-Info.plist file.

For example, I have the following script under <project-root>/hooks/after_prepare/010_modify_plist.sh which adds a dictionary property and adds an entry within that dictionary:

#!/bin/bash


PLIST=platforms/ios/*/*-Info.plist


cat << EOF |
Add :NSAppTransportSecurity dict
Add :NSAppTransportSecurity:NSAllowsArbitraryLoads bool YES
EOF
while read line
do
/usr/libexec/PlistBuddy -c "$line" $PLIST
done


true

Be sure to make the script executable (chmod +x).

The true at the end of the script is because PlistBuddy returns with an error exit code if the key being added already exists, and doesn't provide a way to detect if the key already exists. Cordova will report a build error if the hook script exits with an error status. Better error handling is possible but a pain to implement.

I really like @james's solution using a Cordova hook. However, there are two issues. The docs state:

  • "we highly recommend writing your hooks using Node.js"
  • "/hooks directory is considered deprecated in favor of the hook elements in config.xml"

Here's a Node.js implementation using the plist NPM package:

var fs    = require('fs');     // nodejs.org/api/fs.html
var plist = require('plist');  // www.npmjs.com/package/plist


var FILEPATH = 'platforms/ios/.../...-Info.plist';


module.exports = function (context) {


var xml = fs.readFileSync(FILEPATH, 'utf8');
var obj = plist.parse(xml);


obj.GDLibraryMode = 'GDEnterpriseSimulation';


xml = plist.build(obj);
fs.writeFileSync(FILEPATH, xml, { encoding: 'utf8' });


};

Of all the hook types provided by Cordova, the relevant ones for your situation are:

  • after_prepare
  • before_compile

Choose a hook type, and then add the hook to your config.xml file:

<platform name="ios">
<hook type="after_prepare" src="scripts/my-hook.js" />
</platform>

I have used this plugin to solve the problem, maybe it can help you :

https://www.npmjs.com/package/cordova-plugin-queries-schemes

These are the steps I ended up doing to enable my application to share files through itunes between devices.

1.In your application navigate to your config.xml. Type this piece into your config under the platform tag <platform name="ios">.

 <config-file platform="ios" target="*-Info.plist" parent="UIFileSharingEnabled">
<true/>
</config-file>

2. Then go to your command line tool and type: cordova prepare

  1. Uninstall and reinstall your application on your device, and you will see your app appear in itunes for you to share any files between your devices.

A few things, make sure cordova is up to date, and that you added the platform for ios.

npm install -g cordova

This command installs cordova.

cordova platform add ios

This command adds the platform for ios.

What is happening is when you run the cordova prepare command you are using Apple's Xcode SDK that is generated in the platform/ios folder. There you can see the plist file that is generated for your application, which is labeled as "yourApp-info.plist". There you can see the new key and string produced in the xml layout which looks like this:

 <key>UIFileSharingEnabled</key>
<true/>

Also word of warning, my company dropped this ionic framework application into my lap a couple weeks ago (with a really short deadline). Everything I am telling you is based on couple weeks of learning. So this may not be the best practice, but I hope it helps someone out.

Edit

Link to the docs

If you are trying to modify a .plist in a native iOS plugin with a <config-file> tag in your plugin.xml, here is what you need to do:

  1. Make sure your .plist is xml, not binary! You can use plutil to convert a binary .plist into xml, and commit it to version control.

    plutil -convert xml1 Info.plist

  2. The instructions for <config-file> indicate that target= is relative to the generated xcode project at platforms/ios/<project>/, but I found that I needed to prepend a wildcard character to my path to get it to work:

    target="*/Resources/MyResources.bundle/Info.plist"

  3. If you want to add a key at the top level of the .plist, you need to set parent equal to the key name, and then nest a <string> tag with the value. Using an <array> or <dict> as any examples show will cause these keys to be nested under parent.

Here is a complete example that works for me for adding multiple top level properties:

<platform name="ios">
<config-file target="*/Resources/MyResources.bundle/Info.plist" parent="MyDistribution">
<string>Cordova</string>
</config-file>
<config-file target="*/Resources/MyResources.bundle/Info.plist" parent="MyVersion">
<string>3.2.0</string>
</config-file>
</platform>

@TachyonVortex solution seems to be the best option but was crashing down in my case. The issue was caused by an empty NSMainNibFile field that is not right converted by the plist NPM package. In the .plist file

    <key>NSMainNibFile</key>
<string></string>
<key>NSMainNibFile~ipad</key>
<string></string>

is converted to:

    <key>NSMainNibFile</key>
<string>NSMainNibFile~ipad</string>

I fixed it with by adding to the script:

    obj.NSMainNibFile = '';
obj['NSMainNibFile~ipad'] = '';

The script finally looks like (scripts/my-hook.js):

var fs    = require('fs');     // nodejs.org/api/fs.html
var plist = require('plist');  // www.npmjs.com/package/plist


var FILEPATH = 'platforms/ios/***/***-Info.plist';


module.exports = function (context) {


var xml = fs.readFileSync(FILEPATH, 'utf8');
var obj = plist.parse(xml);


obj.GDLibraryMode = 'GDEnterpriseSimulation';
obj.NSMainNibFile = '';
obj['NSMainNibFile~ipad'] = '';


xml = plist.build(obj);
fs.writeFileSync(FILEPATH, xml, { encoding: 'utf8' });


};

and config.xml:

<platform name="ios">
<hook type="before_build" src="scripts/my-hook.js" />
</platform>

This does seem to be possible now using the config.xml: at least some core plugin authors say so. For instance, in the docs for the Cordova Camera Plugin, they discuss the new requirement in iOS 10 that you provide a permission message string in the plist. To accomplish it, they suggest executing the plugin add command with arguments, thus:

cordova plugin add cordova-plugin-camera --variable CAMERA_USAGE_DESCRIPTION="My App would like to access your camera, to take photos of your documents."

This has the result that you not only get a new <plugin> added to config.xml, but it has a <variable> child:

<plugin name="cordova-plugin-camera" spec="~2.3.0">
<variable name="CAMERA_USAGE_DESCRIPTION" value="My App would like to access your camera, to take photos of your documents." />
</plugin>

Which then seems to correlate to the new keys in my info.plist, perhaps somehow passing the values at runtime?

  <key>NSCameraUsageDescription</key>
<string/>
<key>NSPhotoLibraryUsageDescription</key>
<string/>

I'd be lying if I said that I know exactly how it works, but it seems to point the way.

I prefer the after_prepare hook for bigger projects or if you have multiple plugins using the same permissions. But you can always go the simple way:

simply: - remove the plugin that requires the desired permission - add it again with --save - in config.xml, the plugin now has a new variable with a blank description that you can fill in - now build ios with -- release and they will be set.

UPDATE: for people want to use camera with iOS >= 10. This mean, by normal you can config in plugin as:

 <!-- ios -->
<platform name="ios">


<config-file target="*-Info.plist" parent="NSLocationWhenInUseUsageDescription">
<string></string>
</config-file>
<config-file target="*-Info.plist" parent="NSCameraUsageDescription">
<string></string>
</config-file>
<config-file target="*-Info.plist" parent="NSPhotoLibraryUsageDescription">
<string></string>
</config-file>


</platform>

But for now, you can't config NSCameraUsageDescription and NSPhotoLibraryUsageDescription in plugin. You need to config them in platform -> iOS project by Xcode or in *-Info.plist file.

Since iOS 10 it's mandatory to add a NSCameraUsageDescription and NSPhotoLibraryUsageDescription in the info.plist.

Learn more: https://www.npmjs.com/package/cordova-plugin-camera

I'm using the following in the ionic 3 without any additional plugin or imports and I think this could be helpful for others:

<platform name="ios">
<edit-config file="*-Info.plist" mode="merge" target="NSLocationWhenInUseUsageDescription">
<string>Location is required so we can show you your nearby projects to support.</string>
</edit-config>
<edit-config file="*-Info.plist" mode="merge" target="NSCameraUsageDescription">
<string>Camera accesss required in order to let you select profile picture from camera.</string>
</edit-config>
<edit-config file="*-Info.plist" mode="merge" target="NSPhotoLibraryUsageDescription">
<string>Photo library accesss required in order to let you select profile picture from gallery / library.</string>
</edit-config>
</platform>

Yes, it is possible!

I am using Cordova 9.0.0 (cordova-lib@9.0.1).

For example this is the configuration file that I used to insert new string value into Info.plist :

<platform name="ios">
<edit-config file="*-Info.plist" mode="merge" target="NSMicrophoneUsageDescription">
<string>My awesome app wish to hear your awesome voice through Microphone. Not for fancy stuff, just want to hear you.</string>
</edit-config>
<edit-config file="*-Info.plist" mode="merge" target="---Key configuration---">
<string>---string value---</string>
</edit-config>
</platform>

After that, don't forget to rebuild your staging file by running this two command in your terminal :

cordova platform rm ios
cordova platform add ios

To confirm the change, you can check the newly generated .plist file by opening them with xCode.

-Info.plist file located at :

./platform/ios/[your app name]/[your app name]-Info.plist